用語集

OpenTelemetry で使用されるテレメトリー用語の定義と規則

この用語集は、OpenTelemetry プロジェクトに対して新しい、用語と概念を定義し、オブザーバビリティの分野で一般的に使われている OpenTelemetry 特有の使用法を明確にします。また、役に立つように、スペルや大文字かについてもコメントしました。たとえば、OpenTelemetry と OTel を参照してください。

用語

集約（集計、アグリゲーション）

複数の測定値を組み合わせて、プログラム実行中のある時間間隔に行われた測定値に関する正確な統計値または推定統計値にするプロセス。メトリクスのデータソースで使用されます。

API

アプリケーション・プログラミング・インターフェース。 OpenTelemetryプロジェクトでは、データソースごとにどのようにテレメトリーデータを生成するかを定義するために使用されます。

アプリケーション

エンドユーザーや他のアプリケーションのために設計された1つ以上のサービス。

APM

アプリケーション・パフォーマンス・モニタリングは、ソフトウェアアプリケーション、そのパフォーマンス（スピード、信頼性、可用性など）を監視し、問題を検出し、根本原因を見つけるためのアラートとツールを提供することを指します。

属性（アトリビュート）

メタデータのOpenTelemetry用語。テレメトリーを生成するエンティティにキーバリュー情報を追加します。シグナルとリソースにまたがって使用されます。属性仕様を参照のこと。

自動計装

エンドユーザーがアプリケーションのソースコードを変更する必要のないテレメトリー収集方法を指します。方法はプログラミング言語によって異なり、バイトコードインジェクションやモンキーパッチがその例です。

バゲッジ

イベントとサービスの因果関係を確立するためのメタデータを伝播するメカニズム。バゲッジ仕様を参照のこと。

クライアントライブラリ

計装済みライブラリ.

クライアントサイドアプリケーション

アプリケーションのコンポーネントで、プライベートなインフラストラクチャ内で実行されておらず、通常エンドユーザーが直接使用するもの。クライアントサイドアプリの例としては、ブラウザアプリ、モバイルアプリ、IoTデバイス上で動作するアプリなどがあります。

コレクター

OpenTelemetry コレクターまたは短くしてコレクターは、テレメトリーデータの受信、処理、エクスポート方法に関するベンダー非依存の実装です。エージェントまたはゲートウェイとしてデプロイ可能な単一のバイナリです。

OpenTelemetry コレクターを指す場合は、常に「コレクター」と大文字で記載してください。「コレクター」を形容詞として使用する場合（例：「コレクターの設定」）も、「コレクター」と記載してください（英語では大文字で Collector と書くことを示しているが、日本語の場合はコレクターと記述する）。

Contrib

いくつかの計装ライブラリとコレクターはコア機能のセットと、ベンダーの エクスポーター を含む非コア機能専用のcontribリポジトリを提供しています。

コンテキスト伝搬（プロパゲーション）

すべてのデータソースが、トランザクションの寿命にわたって状態を保存したりデータにアクセスしたりするための基盤となるコンテキストメカニズムを共有できるようにします。コンテキスト伝播仕様を参照。

DAG

有向非巡回グラフ（Directed Acyclic Graph）のこと。

データソース

シグナルを参照のこと。

次元（ディメンション）

メトリクスで特に使われる用語。属性を参照のこと。

分散トレース

アプリケーションを構成するサービスによって処理される、トレースと呼ばれる単一のリクエストの進行を追跡します。分散トレースは、プロセス、ネットワーク、セキュリティの境界を越えます。

分散トレースを参照してください。

ディストリビューション

ディストリビューションとは、アップストリームのOpenTelemetryリポジトリのラッパーで、いくつかのカスタマイズが施されています。ディストリビューションを参照してください。

イベント

イベントは、イベント名とよく知られた構造のログレコードです。たとえば、OpenTelemetry のブラウザイベントは、特有の命名規則に従い、共通の構造における特有のデータを運びます。

エクスポーター

テレメトリーをコンシューマーに送信する機能を提供します。エクスポーターはプッシュベースかプルベースのいずれかになります。

フィールド

ログレコードで特に使われる用語。メタデータは、属性やリソースなどの定義されたフィールドを通して追加できます。重大度やトレース情報など、他のフィールドも Metadata とみなされるかもしれません。フィールド仕様を参照してください。

gRPC

高性能でオープンソースのユニバーサル RPC フレームワーク。 gRPCの詳細はこちら。

HTTP

Hypertext Transfer Protocol（ハイパーテキスト・トランスファー・プロトコル）の略。

計装済みライブラリ

テレメトリーシグナル(トレース、メトリクス、ログ)を収集するライブラリを表します。詳細はこちら参照してください。

計装ライブラリ

特定の計装済みライブラリに計装を提供するライブラリを表します。計装済みライブラリと計装ライブラリは、ビルトインのOpenTelemetry計装をしている場合、同一のライブラリになります。ライブラリ仕様を参照のこと。

JSON

JavaScript Object Notationの略。

ラベル

メトリクスで特に使われる用語。メタデータを参照。

言語

プログラミング言語のこと。

ライブラリ

インターフェイスによって呼び出される動作の言語固有のコレクション。

ログ

ログレコードの集まりを指すのに使われることもあります。また、単一のログ記録を指すためにログを使うこともあるので、曖昧になる可能性があります。曖昧になる可能性がある場合は、追加の修飾子、たとえばログレコードを使用してください。詳細はログを参照してください。

ログレコード

タイムスタンプと重要度のデータの記録です。トレースと関連があるとき、トレース IDとスパン IDを持つ可能性があります。詳細は、ログレコードを参照してください。

メタデータ

たとえば foo="bar" のようなキーと値のペアで、テレメトリーを生成するエンティティに追加されます。 OpenTelemetryはこれらのペアを属性と呼びます。また、メトリクスには次元とラベルがあり、ログにはフィールドがあります。

メトリクス

生の測定値または事前定義された集計値のいずれかのデータポイントを、メタデータ付きの時系列として記録します。詳細はメトリクスを参照のこと。

OC

OpenCensusの略称。

OpAMP

Open Agent Management Protocol の省略形。

スペル 説明または指示においては OPAMP や opamp でもなく OpAMP と書いてください。

OpenCensus

OpenTelemetry の前身です。詳細については、歴史を参照してください。

OpenTelemetry

OpenTelemetry は、OpenTracing と OpenCensus プロジェクトの統合によって生まれました。 OpenTelemetry — 本サイトの主題である —は、API、SDK、および各種ツールの集合体であり、計装を行い、メトリクス、ログ、トレースなどのテレメトリーデータを生成、収集、およびエクスポートするために使用できます。

スペル OpenTelemetry は常にハイフンなしの一語で記述し、例のように大文字で表記してください。

OpenTracing

OpenTelemetry の前身です。詳細については、歴史を参照してください。

OT

OpenTracingの略称。

OTel

OpenTelemetryの略称。

スペル OTel と書いてください。OTEL ではありません。

OTelCol

OpenTelemetryコレクターの略称。

OTEP

OpenTelemetry Enhancement Proposal の頭字語。

Spelling: “OTEPs” は複数形で記述してください。説明で OTep または otep と書かないでください。

OTLP

OpenTelemetryプロトコルの略称。

プロパゲーター

スパン内のスパンコンテキストやバゲッジなど、テレメトリーデータの特定の部分をシリアライズおよびデシリアライズするために使用します。詳細はプロパゲーターを参照してください。

Proto

言語に依存しないインターフェイス型。詳細はProtoを参照のこと。

レシーバー

コレクターが使用する用語で、テレメトリーデータの受信方法を定義します。レシーバーはプッシュベースとプルベースがあります。詳細はレシーバーのページを参照のこと。

リクエスト

分散トレースを参照のこと。

リソース

テレメトリーを生成するエンティティに関する情報を属性として捕捉します。たとえば、Kubernetes 上のコンテナで実行されているテレメトリーを生成するプロセスには、プロセス名、ポッド名、名前空間、そして場合によってはデプロイメント名があります。これらすべての属性を Resource に含めることができます。

REST

Representational State Transferの略称。

RPC

Remote Procedure Call（リモートプロシージャーコール、遠隔手続き呼び出し）の略称。

サンプリング

エクスポートされるデータ量を制御するメカニズム。トレースデータソースと共に使われるのが一般的です。詳細はサンプリングを参照してください。

SDK

ソフトウェア開発キット（Software Development Kit）の略称。 OpenTelemetryのAPIを実装するライブラリを示すテレメトリSDKを指します。

セマンティック規約

ベンダー非依存のテレメトリーデータを提供するために、メタデータの標準的な名前と値を定義します。

サービス

アプリケーションのコンポーネント。サービスの複数のインスタンスは、通常、高可用性とスケーラビリティのためにデプロイされます。サービスは複数の場所に配置できます。

シグナル

OpenTelemetryにおいてはトレース、メトリクス、ログのいずれか。シグナルの詳細はこちら。

スパン

トレース内の単一の操作を表します。スパンを参照のこと。

スパンリンク

スパンリンクは、因果関係のあるスパン間のリンクです。詳細はスパン間のリンクとリンクの指定を参照してください。

仕様

すべての実装に対する言語横断的な要求と期待を記述しています。詳細は仕様を参照。

ステータス

操作の結果。通常、エラーが発生したかどうかを示すために使用されます。詳細はステータスのページを参照。

トレース

スパンのDAGで、スパン間のエッジ（辺）は親子関係として定義されます。トレースを参照のこと。

トレーサー

スパンの作成を担当します。詳細はトレーサーを参照。

トランザクション