diff --git a/content/ja/docs/concepts/glossary.md b/content/ja/docs/concepts/glossary.md index 5322d8fd865f..966cb7a9f2b4 100644 --- a/content/ja/docs/concepts/glossary.md +++ b/content/ja/docs/concepts/glossary.md @@ -1,320 +1,332 @@ --- title: 用語集 -description: OpenTelemetryプロジェクトで使用されている用語に馴染みがあるものもないものもあるでしょう。 +description: OpenTelemetry で使用されるテレメトリー用語の定義と規則 weight: 200 -default_lang_commit: 21d6bf0 -drifted_from_default: true +default_lang_commit: acdc9eeb0e1c756af25aaf6614027972b0909c78 --- -OpenTelemetryプロジェクトは、あなたが馴染みのない用語を使っているかもしれません。 -また、他のプロジェクトとは異なる方法で用語を定義しています。 -このページでは、OpenTelemetryプロジェクトで使われている用語とその意味を説明します。 +この用語集は、OpenTelemetry プロジェクトに対して新しい、用語と[概念](/docs/concepts/)を定義し、オブザーバビリティの分野で一般的に使われている OpenTelemetry 特有の使用法を明確にします。 +また、役に立つように、スペルや大文字かについてもコメントしました。 +たとえば、[OpenTelemetry](#opentelemetry) と [OTel](#otel) を参照してください。 -## 一般用語 +## 用語 {#terms} -### **集約(集計、アグリゲーション)** {#aggregation} +### 集約(集計、アグリゲーション) {#aggregation} 複数の測定値を組み合わせて、プログラム実行中のある時間間隔に行われた測定値に関する正確な統計値または推定統計値にするプロセス。 [メトリクス](#metric)の[データソース](#data-source) で使用されます。 -### **API** +### API {#api} アプリケーション・プログラミング・インターフェース。 OpenTelemetryプロジェクトでは、[データソース](#data-source)ごとにどのようにテレメトリーデータを生成するかを定義するために使用されます。 -### **アプリケーション** {#application} +### アプリケーション {#application} エンドユーザーや他のアプリケーションのために設計された1つ以上の[サービス](#service)。 -### **APM** +### APM {#apm} アプリケーション・パフォーマンス・モニタリングは、ソフトウェアアプリケーション、そのパフォーマンス(スピード、信頼性、可用性など)を監視し、問題を検出し、根本原因を見つけるためのアラートとツールを提供することを指します。 -### **属性(アトリビュート)** {#attribute} +### 属性(アトリビュート) {#attribute} [メタデータ](#metadata)のOpenTelemetry用語。 テレメトリーを生成するエンティティにキーバリュー情報を追加します。 [シグナル](#signal)と[リソース](#resource) にまたがって使用されます。 [属性仕様][attribute]を参照のこと。 -### **自動計装** +### 自動計装 {#automatic-instrumentation} エンドユーザーがアプリケーションのソースコードを変更する必要のないテレメトリー収集方法を指します。 方法はプログラミング言語によって異なり、バイトコードインジェクションやモンキーパッチがその例です。 -### **バゲッジ** {#baggage} +### バゲッジ {#baggage} イベントとサービスの因果関係を確立するための[メタデータ](#metadata)を伝播するメカニズム。 [バゲッジ仕様][baggage]を参照のこと。 -### **クライアントライブラリ** +### クライアントライブラリ {#client-library} [計装済みライブラリ](#instrumented-library). -### **クライアントサイドアプリケーション** +### クライアントサイドアプリケーション [アプリケーション](#application)のコンポーネントで、プライベートなインフラストラクチャ内で実行されておらず、通常エンドユーザーが直接使用するもの。 クライアントサイドアプリの例としては、ブラウザアプリ、モバイルアプリ、IoTデバイス上で動作するアプリなどがあります。 -### **コレクター** {#collector} +### コレクター {#collector} -テレメトリーデータの受信、処理、エクスポート方法に関するベンダー非依存の実装。 -エージェントまたはゲートウェイとしてデプロイ可能な単一のバイナリ。 +[OpenTelemetry コレクター][OpenTelemetry Collector]または短くしてコレクターは、テレメトリーデータの受信、処理、エクスポート方法に関するベンダー非依存の実装です。 +エージェントまたはゲートウェイとしてデプロイ可能な単一のバイナリです。 -別名OpenTelemetryコレクター。コレクターの詳細は[こちら][collector]を参照してください。 +> OpenTelemetry コレクターを指す場合は、常に「コレクター」と大文字で記載してください。「コレクター」を形容詞として使用する場合(例:「コレクターの設定」)も、「コレクター」と記載してください(英語では大文字で Collector と書くことを示しているが、日本語の場合はコレクターと記述する)。 -### **Contrib** +[OpenTelemetry Collector]: /docs/collector/ + +### Contrib {#contrib} いくつかの[計装ライブラリ](#instrumentation-library)と[コレクター](#collector)はコア機能のセットと、ベンダーの `エクスポーター` を含む非コア機能専用のcontribリポジトリを提供しています。 -### **コンテキスト伝搬(プロパゲーション)** +### コンテキスト伝搬(プロパゲーション) {#context-propagation} すべての[データソース](#data-source)が、[トランザクション](#transaction)の寿命にわたって状態を保存したりデータにアクセスしたりするための基盤となるコンテキストメカニズムを共有できるようにします。 [コンテキスト伝播仕様][context propagation]を参照。 -### **DAG** {#dag} +### DAG {#dag} [有向非巡回グラフ(Directed Acyclic Graph)][dag]のこと。 -### **データソース** {#data-source} +### データソース {#data-source} [シグナル](#signal)を参照のこと。 -### **次元(ディメンション)** {#dimension} +### 次元(ディメンション) {#dimension} [メトリクス](#metric)で特に使われる用語。[属性](#attribute)を参照のこと。 -### **分散トレース** {#distributed-tracing} +### 分散トレース {#distributed-tracing} [アプリケーション](#application)を構成する[サービス](#service)によって処理される、[トレース](#trace)と呼ばれる単一の[リクエスト](#request)の進行を追跡します。 [分散トレース](#distributed-tracing)は、プロセス、ネットワーク、セキュリティの境界を越えます。 [分散トレース][distributed tracing]を参照してください。 -### **ディストリビューション** {#distribution} +### ディストリビューション {#distribution} ディストリビューションとは、アップストリームのOpenTelemetryリポジトリのラッパーで、いくつかのカスタマイズが施されています。 [ディストリビューション][distribution]を参照してください。 -### **イベント** {#event} +### イベント {#event} -表現が[データソース](#data-source)に依存するところで起こった何か。 -たとえば、[スパン](#span)。 +イベントは、イベント名とよく知られた構造の[ログレコード](#log-record)です。 +たとえば、OpenTelemetry のブラウザイベントは、特有の命名規則に従い、共通の構造における特有のデータを運びます。 -### **エクスポーター** {#exporter} +### エクスポーター {#exporter} テレメトリーをコンシューマーに送信する機能を提供します。 エクスポーターはプッシュベースかプルベースのいずれかになります。 -### **フィールド** {#field} +### フィールド {#field} [ログレコード](#log-record)で特に使われる用語。 [メタデータ](#metadata)は、[属性](#attribute)や[リソース](#resource)などの定義されたフィールドを通して追加できます。 重大度やトレース情報など、他のフィールドも `Metadata` とみなされるかもしれません。 [フィールド仕様][field]を参照してください。 -### **gRPC** +### gRPC {#grpc} 高性能でオープンソースのユニバーサル [RPC](#rpc) フレームワーク。 gRPCの詳細は[こちら](https://grpc.io)。 -### **HTTP** +### HTTP {#http} [Hypertext Transfer Protocol(ハイパーテキスト・トランスファー・プロトコル)][http]の略。 -### **計装済みライブラリ** {#instrumented-library} +### 計装済みライブラリ {#instrumented-library} テレメトリーシグナル([トレース](#trace)、[メトリクス](#metric)、[ログ](#log))を収集する[ライブラリ](#library)を表します。 詳細は[こちら][spec-instrumented-lib]参照してください。 -### **計装ライブラリ** {#instrumentation-library} +### 計装ライブラリ {#instrumentation-library} 特定の[計装済みライブラリ](#instrumented-library)に計装を提供する[ライブラリ](#library)を表します。 [計装済みライブラリ](#instrumented-library)と[計装ライブラリ](#instrumentation-library)は、ビルトインのOpenTelemetry計装をしている場合、同一の[ライブラリ](#library)になります。 [ライブラリ仕様][spec-instrumentation-lib]を参照のこと。 -### **JSON** +### JSON {#json} [JavaScript Object Notation][json]の略。 -### **ラベル** {#label} +### ラベル {#label} [メトリクス](#metric)で特に使われる用語。 [メタデータ](#metadata)を参照。 -### **言語** +### 言語 {#language} プログラミング言語のこと。 -### **ライブラリ** {#library} +### ライブラリ {#library} インターフェイスによって呼び出される動作の言語固有のコレクション。 -### **ログ** {#log} +### ログ {#log} [ログレコード](#log-record)の集まりを指すのに使われることもあります。 また、単一の[ログ記録](#log-record)を指すために[ログ](#log)を使うこともあるので、曖昧になる可能性があります。 曖昧になる可能性がある場合は、追加の修飾子、たとえば`ログレコード`を使用してください。 詳細は[ログ][log]を参照してください。 -### **ログレコード** {#log-record} +### ログレコード {#log-record} -[イベント](#event)の記録。 -通常、[イベント](#event)がいつ起こったかを示すタイムスタンプと、何が起こったか、どこで起こったかなどを示すその他のデータが記録されます。 -詳細は[ログレコード][log record]を参照してください。 +タイムスタンプと重要度のデータの記録です。 +トレースと関連があるとき、[トレース ID](#trace)と[スパン ID](#span)を持つ可能性があります。 +詳細は、[ログレコード][log record]を参照してください。 -### **メタデータ** {#metadata} +### メタデータ {#metadata} たとえば `foo="bar"` のようなキーと値のペアで、テレメトリーを生成するエンティティに追加されます。 OpenTelemetryはこれらのペアを[属性](#attribute)と呼びます。 また、[メトリクス](#metric)には[次元](#dimension)と[ラベル](#label)があり、[ログ](#log)には[フィールド](#field)があります。 -### **メトリクス** {#metric} +### メトリクス {#metric} 生の測定値または事前定義された集計値のいずれかのデータポイントを、[メタデータ](#metadata)付きの時系列として記録します。 詳細は[メトリクス][metric]を参照のこと。 -### **OC** +### OC {#oc} [OpenCensus](#opencensus)の略称。 -### OpAMP +### OpAMP {#opamp} + +[Open Agent Management Protocol](/docs/collector/management/#opamp) の省略形。 + +> **スペル** 説明または指示においては `OPAMP` や `opamp` でもなく OpAMP と書いてください。 + +### OpenCensus {#opencensus} -[コンテンツは後日追加されます] +OpenTelemetry の前身です。詳細については、[歴史](/docs/what-is-opentelemetry/#history) を参照してください。 -### **OpenCensus** +### OpenTelemetry {#opentelemetry} -アプリケーションのメトリクスと分散トレースを収集し、リアルタイムで任意のバックエンドにデータを転送することを可能にする、さまざまな言語用のライブラリのセットです。 -[OpenTelemetryの前身](/docs/what-is-opentelemetry/#history)プロジェクトです。 -詳細は[このサイト][opencensus]を参照のこと。 +OpenTelemetry は、[OpenTracing](#opentracing) と [OpenCensus](#opencensus) プロジェクトの[統合][merger]によって生まれました。 +OpenTelemetry — 本サイトの主題である —は、[API](#api)、[SDK](#sdk)、および各種ツールの集合体であり、[計装](/docs/concepts/instrumentation/)を行い、[メトリクス](#metric)、[ログ](#log)、[トレース](#trace)などの[テレメトリーデータ](/docs/concepts/signals/)を生成、[収集](/docs/concepts/components/#collector)、および[エクスポート](/docs/concepts/components/#exporters)するために使用できます。 -### OpenTelemetry +> **スペル** OpenTelemetry は常にハイフンなしの一語で記述し、例のように大文字で表記してください。 -[コンテンツは後日追加されます] +[merger]: /docs/what-is-opentelemetry/#history -### **OpenTracing** +### OpenTracing {#opentracing} -分散トレーシングのためのベンダーニュートラルなAPIと計装。 -[OpenTelemetryの前身](/docs/what-is-opentelemetry/#history)プロジェクトです。 -詳細は[このサイト][opentracing]を参照のこと。 +OpenTelemetry の前身です。 +詳細については、[歴史](/docs/what-is-opentelemetry/#history)を参照してください。 -### **OT** +### OT {#ot} [OpenTracing](#opentracing)の略称。 -### **OTel** +### OTel {#otel} [OpenTelemetry](/docs/what-is-opentelemetry/)の略称。 -### **OTelCol** +> **スペル** OTel と書いてください。`OTEL` ではありません。 + +### OTelCol {#otelcol} [OpenTelemetryコレクター](#collector)の略称。 -### OTEP +### OTEP {#otep} + +[OpenTelemetry Enhancement Proposal] の頭字語。 + +> **Spelling**: "OTEPs" は複数形で記述してください。 +> 説明で `OTep` または `otep` と書かないでください。 -[コンテンツは後日追加されます] +[OpenTelemetry Enhancement Proposal]: https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/README.md -### **OTLP** +### OTLP {#otlp} [OpenTelemetryプロトコル](/docs/specs/otlp/)の略称。 -### **プロパゲーター** {#propagators} +### プロパゲーター {#propagators} [スパン](#span)内のスパンコンテキストや[バゲッジ](#baggage)など、テレメトリーデータの特定の部分をシリアライズおよびデシリアライズするために使用します。 詳細は[プロパゲーター][propagators]を参照してください。 -### **Proto** +### Proto {#proto} 言語に依存しないインターフェイス型。詳細は[Proto][proto]を参照のこと。 -### **レシーバー** {#receiver} +### レシーバー {#receiver} [コレクター](/docs/collector/configuration/#receivers)が使用する用語で、テレメトリーデータの受信方法を定義します。 レシーバーはプッシュベースとプルベースがあります。 詳細は[レシーバー][receiver]のページを参照のこと。 -### **リクエスト** {#request} +### リクエスト {#request} [分散トレース](#distributed-tracing)を参照のこと。 -### **リソース** {#resource} +### リソース {#resource} テレメトリーを生成するエンティティに関する情報を[属性](#attribute)として捕捉します。 たとえば、Kubernetes 上のコンテナで実行されているテレメトリーを生成するプロセスには、プロセス名、ポッド名、名前空間、そして場合によってはデプロイメント名があります。 これらすべての属性を `Resource` に含めることができます。 -### **REST** +### REST {#rest} [Representational State Transfer][rest]の略称。 -### **RPC** +### RPC {#rpc} [Remote Procedure Call(リモートプロシージャーコール、遠隔手続き呼び出し)][rpc]の略称。 -### **サンプリング** {#sampling} +### サンプリング {#sampling} エクスポートされるデータ量を制御するメカニズム。 [トレース](#trace) [データソース](#data-source) と共に使われるのが一般的です。 詳細は[サンプリング][sampling]を参照してください。 -### **SDK** +### SDK {#sdk} ソフトウェア開発キット(Software Development Kit)の略称。 OpenTelemetryの[API](#api)を実装する[ライブラリ](#library)を示すテレメトリSDKを指します。 -### **セマンティック規約** {#semantic-conventions} +### セマンティック規約 {#semantic-conventions} ベンダー非依存のテレメトリーデータを提供するために、[メタデータ](#metadata)の標準的な名前と値を定義します。 -### **サービス** {#service} +### サービス {#service} [アプリケーション](#application)のコンポーネント。 [サービス](#service)の複数のインスタンスは、通常、高可用性とスケーラビリティのためにデプロイされます。 [サービス](#service)は複数の場所に配置できます。 -### **シグナル** {#signal} +### シグナル {#signal} OpenTelemetryにおいては[トレース](#trace)、[メトリクス](#metric)、[ログ](#log)のいずれか。 シグナルの詳細は[こちら][signals]。 -### **スパン** {#span} +### スパン {#span} [トレース](#trace)内の単一の操作を表します。[スパン][span]を参照のこと。 -### **スパンリンク** {#span-link} +### スパンリンク {#span-link} スパンリンクは、因果関係のあるスパン間のリンクです。 詳細は[スパン間のリンク](/docs/specs/otel/overview#links-between-spans)と[リンクの指定](/docs/specs/otel/trace/api#specifying-links)を参照してください。 -### **仕様** {#specification} +### 仕様 {#specification} すべての実装に対する言語横断的な要求と期待を記述しています。 詳細は[仕様][specification]を参照。 -### **ステータス** {#status} +### ステータス {#status} 操作の結果。 通常、エラーが発生したかどうかを示すために使用されます。 詳細は[ステータス][status]のページを参照。 -### **タグ** {#tag} +### タグ {#tag} [メタデータ](#metadata)を参照のこと。 -### **トレース** {#trace} +### トレース {#trace} [スパン](#span)の[DAG](#dag)で、[スパン](#span)間のエッジ(辺)は親子関係として定義されます。 [トレース][trace]を参照のこと。 -### **トレーサー** {#tracer} +### トレーサー {#tracer} [スパン](#span)の作成を担当します。詳細は[トレーサー][tracer]を参照。 -### **トランザクション** {#transaction} +### トランザクション {#transaction} [分散トレース](#distributed-tracing)を参照のこと。 -### **zPages** +### zPages {#zpages} 外部エクスポーターにかわるプロセス内エクスポーター。 これを使うと、トレースとメトリクスの情報をバックグラウンドで収集し、集約できます。 @@ -322,7 +334,6 @@ OpenTelemetryにおいては[トレース](#trace)、[メトリクス](#metric) [baggage]: /docs/specs/otel/baggage/api/ [attribute]: /docs/specs/otel/common/#attributes -[collector]: /docs/collector [context propagation]: /docs/specs/otel/overview#context-propagation [dag]: https://en.wikipedia.org/wiki/Directed_acyclic_graph [distributed tracing]: /docs/concepts/signals/traces/ @@ -333,8 +344,6 @@ OpenTelemetryにおいては[トレース](#trace)、[メトリクス](#metric) [log]: /docs/specs/otel/glossary#log [log record]: /docs/specs/otel/glossary#log-record [metric]: /docs/concepts/signals/metrics/ -[opencensus]: https://opencensus.io -[opentracing]: https://opentracing.io [propagators]: /docs/languages/go/instrumentation/#propagators-and-context [proto]: https://github.com/open-telemetry/opentelemetry-proto [receiver]: /docs/collector/configuration/#receivers