計装

OpenTelemetryはどのように計装を促進するか

The content of this page may be outdated and some links may be invalid. A newer version of this page exists in English.

More information ...

To see the changes to the English page since this page was last updated: visit GitHub compare 94d77ab8..efeda2d8 and search for content/en/docs/concepts/instrumentation/_index.md.

システムを観測可能にするため、システムが 計装 されなければなりません。 つまり、システムコンポーネントのコードがトレースメトリクスログといったシグナルを送出しなければなりません。

OpenTelemetry を使えば、主に2つの方法でコードを計装できます。

  1. 公式の各言語向けのAPIとSDKを使ったコードベースソリューション
  2. ゼロコードソリューション

コードベース ソリューションは、より深い洞察とリッチなテレメトリーをアプリケーション自身から得ることを可能にします。 OpenTelemetry APIを使ってアプリケーションからテレメトリーを生成でき、ゼロコードソリューションによって生成されたテレメトリーを補完する重要な役割を果たします。

ゼロコード ソリューションは、テレメトリーの取得を初めて行うときや、テレメトリーを取得する必要のあるアプリケーションを修正できない時に最適です。 それらは、あなたが使用しているライブラリや、アプリケーションが動作している環境から、豊富なテレメトリーを提供します。 別の考え方をすれば、アプリケーションの エッジで 何が起こっているかについての情報を提供する、ということです。

両方のソリューションを同時に使うこともできます。

OpenTelemetryのその他の利点

OpenTelemetryが提供するのは、ゼロコードやコードベースのテレメトリーソリューションだけではありません。 以下のものもOpenTelemetryの一部です。

  • ライブラリは依存関係として OpenTelemetry API を活用することができ、OpenTelemetry SDK がインポートされない限り、そのライブラリを使用するアプリケーションに影響はありません。
  • それぞれのシグナル(トレース、メトリクス、ログ)に対して、それらを作成、処理、エクスポートするためのいくつかの方法が用意されています。
  • コンテキスト伝播が実装に組み込まれているので、シグナルがどこで生成されたかに関係なく、シグナルを相関させられます。
  • リソース計装スコープは、ホストオペレーティングシステムKubernetesクラスターのように、異なるエンティティごとにシグナルをグループ化できます。
  • APIとSDKの各言語固有の実装は、OpenTelemetry仕様の要件と期待に従います。
  • セマンティック規約は、コードベースやプラットフォーム間で標準化のために使用できる共通の命名スキーマを提供します。

ゼロコード

コードを書かずにアプリケーションにオブザーバビリティを追加する方法を学ぶ

コードベース

コードベース計装のセットアップに不可欠なステップを学ぶ

ライブラリ

ライブラリにネイティブ計装を追加する方法を紹介します。


最終更新 March 21, 2025: Test-and-fix results (#6593) (0369108b)