# OpenTelemetry Specification

> Source: https://www.ymotongpoo.com/works/otel-specs-ja/spec/


## 目次

- [概要](./overview/)
- [用語集](./glossary/)
- 原則とガイドライン
  - [基本原則](./specification-principles/)
  - [OpenTelemetryクライアントのバージョニングと安定性](./versioning-and-stability/)
  - [ライブラリガイドライン](./library-guidelines/)
    - [パッケージ/ライブラリのレイアウト](./library-layout/)
    - [一般的なエラー処理のガイドライン](./error-handling/)
    - [自己オブザーバビリティ](./self-observability/)
  - [パフォーマンス](./performance/)
- API仕様
  - [コンテキスト](/works/otel-specs-ja/spec/context/)
    - [プロパゲーター](/works/otel-specs-ja/spec/context/api-propagators/)
    - [環境変数キャリア](/works/otel-specs-ja/spec/context/env-carriers/)
  - [バゲージ](/works/otel-specs-ja/spec/baggage/api/)
  - [トレーシング](./trace/api/)
  - [メトリクス](./metrics/api/)
  - [ログ](./logs/)
    - [API](./logs/api/)
- SDK仕様
  - [トレーシング](./trace/sdk/)
  - [メトリクス](./metrics/sdk/)
  - [ログ](./logs/sdk/)
  - [リソース](./resource/)
  - [設定](./configuration/)
- データ仕様
  - [セマンティック規約](./overview/#セマンティック規約)
  - [プロトコル](/works/otel-specs-ja/spec/protocol/)
    - [メトリクス](/works/otel-specs-ja/spec/metrics/data-model/)
    - [ログ](/works/otel-specs-ja/spec/logs/data-model/)
    - [プロファイル](/works/otel-specs-ja/spec/profiles/mappings/)
  - 互換性
    - [OpenCensus](/works/otel-specs-ja/spec/compatibility/opencensus/)
    - [OpenTracing](/works/otel-specs-ja/spec/compatibility/opentracing/)
    - [Prometheus and OpenMetrics](/works/otel-specs-ja/spec/compatibility/prometheus_and_openmetrics/)
    - [非OTLPログフォーマットにおけるトレースコンテキスト](/works/otel-specs-ja/spec/compatibility/logging_trace_context/)

## 表記規則と準拠

[仕様書][]中に登場するキーワード「MUST」「MUST NOT」「REQUIRED」「SHOULD」「SHOULD NOT」「RECOMMENDED」「NOT RECOMMENDED」「MAY」「OPTIONAL」は、ここに示すようにすべて大文字で書かれている場合に限り、[BCP 14](https://www.rfc-editor.org/info/bcp14)（[RFC2119](https://datatracker.ietf.org/doc/html/rfc2119)、[RFC8174](https://datatracker.ietf.org/doc/html/rfc8174)）に記載の通りに解釈されるものとします。

[仕様書][]の実装は、[仕様書][]で定義された「MUST」「MUST NOT」「REQUIRED」の要求事項を1つ以上満たさない場合、準拠しているとはみなされません。逆に、[仕様書][]で定義されたすべての「MUST」「MUST NOT」「REQUIRED」の要求事項を満たす[仕様書][]の実装は、準拠しているとみなされます。

## プロジェクトの名称について

- 公式のプロジェクト名は「OpenTelemetry」です（「Open」と「Telemetry」の間にスペースはありません）。
- OpenTelemetryプロジェクトが使用する公式の略称は「OTel」です。「OT」は、OTCA（OpenTelemetry Certified Associate）のような、より長い略称の一部としてのみ使用してもよい（MAY）ものとします。
- 言語固有の実装などのサブプロジェクトの公式名称は、「OpenTelemetry {プログラミング言語・ランタイム・コンポーネント名}」というパターンに従います。例: "OpenTelemetry Python"、"OpenTelemetry .NET"、"OpenTelemetry Collector"。

## プロジェクトについて

以下を含む情報については、[プロジェクトリポジトリ][]を参照してください。

- [変更・コントリビューションプロセス](https://github.com/open-telemetry/opentelemetry-specification#change--contribution-process)
- [プロジェクトのタイムライン](https://github.com/open-telemetry/opentelemetry-specification#project-timeline)
- [仕様書のバージョニング](https://github.com/open-telemetry/opentelemetry-specification#versioning-the-specification)
- [ライセンス](https://github.com/open-telemetry/opentelemetry-specification#license)

[プロジェクトリポジトリ]: https://github.com/open-telemetry/opentelemetry-specification
[仕様書]: ./overview/

- [Entity](/works/otel-specs-ja/spec/entities/)
- [OpenTelemetry Profiles](/works/otel-specs-ja/spec/profiles/)
- [OpenTelemetryのメトリクス](/works/otel-specs-ja/spec/metrics/)
- [OpenTelemetryのログ](/works/otel-specs-ja/spec/logs/)
- [コンテキスト](/works/otel-specs-ja/spec/context/)
- [スキーマ](/works/otel-specs-ja/spec/schemas/)
- [トレース](/works/otel-specs-ja/spec/trace/)
- [バゲージ](/works/otel-specs-ja/spec/baggage/)
- [プロトコル](/works/otel-specs-ja/spec/protocol/)
- [リソース](/works/otel-specs-ja/spec/resource/)
- [互換性](/works/otel-specs-ja/spec/compatibility/)
- [共通概念](/works/otel-specs-ja/spec/common/)
- [設定](/works/otel-specs-ja/spec/configuration/)
- [Baggage API](/works/otel-specs-ja/spec/baggage/api/)
- [スキーマファイル形式 1.0.0](/works/otel-specs-ja/spec/schemas/file_format_v1.0.0/)
- [トレーシングAPI](/works/otel-specs-ja/spec/trace/api/)
- [トレースエクスポーター - 標準出力](/works/otel-specs-ja/spec/trace/sdk_exporters/stdout/)
- [メトリクスAPI](/works/otel-specs-ja/spec/metrics/api/)
- [メトリクスエクスポーター - インメモリ](/works/otel-specs-ja/spec/metrics/sdk_exporters/in-memory/)
- [ログAPI](/works/otel-specs-ja/spec/logs/api/)
- [概要](/works/otel-specs-ja/spec/overview/)
- [計装設定API](/works/otel-specs-ja/spec/configuration/api/)
- [設計目標](/works/otel-specs-ja/spec/protocol/design-goals/)
- [Entityデータモデル](/works/otel-specs-ja/spec/entities/data-model/)
- [OTLPエクスポーター](/works/otel-specs-ja/spec/protocol/exporter/)
- [スキーマファイル形式 1.1.0](/works/otel-specs-ja/spec/schemas/file_format_v1.1.0/)
- [トレースエクスポーター - Zipkin](/works/otel-specs-ja/spec/trace/sdk_exporters/zipkin/)
- [メトリクスエクスポーター - OTLP](/works/otel-specs-ja/spec/metrics/sdk_exporters/otlp/)
- [メトリクスのデータモデル](/works/otel-specs-ja/spec/metrics/data-model/)
- [リソースのデータモデル](/works/otel-specs-ja/spec/resource/data-model/)
- [ログのデータモデル](/works/otel-specs-ja/spec/logs/data-model/)
- [用語集](/works/otel-specs-ja/spec/glossary/)
- [設定データモデル](/works/otel-specs-ja/spec/configuration/data-model/)
- [Entity Event](/works/otel-specs-ja/spec/entities/entity-events/)
- [OTLPファイルエクスポーター](/works/otel-specs-ja/spec/protocol/file-exporter/)
- [トレーシングSDK](/works/otel-specs-ja/spec/trace/sdk/)
- [メトリクスSDK](/works/otel-specs-ja/spec/metrics/sdk/)
- [メトリクスエクスポーター - Prometheus](/works/otel-specs-ja/spec/metrics/sdk_exporters/prometheus/)
- [リソースSDK](/works/otel-specs-ja/spec/resource/sdk/)
- [ログSDK](/works/otel-specs-ja/spec/logs/sdk/)
- [仕様書の原則](/works/otel-specs-ja/spec/specification-principles/)
- [設定SDK](/works/otel-specs-ja/spec/configuration/sdk/)
- [OpenTelemetryクライアントのバージョニングと安定性](/works/otel-specs-ja/spec/versioning-and-stability/)
- [メトリクスエクスポーター - 標準出力](/works/otel-specs-ja/spec/metrics/sdk_exporters/stdout/)
- [要求事項](/works/otel-specs-ja/spec/protocol/requirements/)
- [ドキュメントステータスの定義](/works/otel-specs-ja/spec/document-status/)
- [OpenTelemetryクライアント設計原則](/works/otel-specs-ja/spec/library-guidelines/)
- [OpenTelemetryプロジェクトのパッケージレイアウト](/works/otel-specs-ja/spec/library-layout/)
- [OpenTelemetryにおけるエラー処理](/works/otel-specs-ja/spec/error-handling/)
- [自己オブザーバビリティ](/works/otel-specs-ja/spec/self-observability/)
- [OpenTelemetry APIのパフォーマンスとブロッキング](/works/otel-specs-ja/spec/performance/)
- [テレメトリーの安定性](/works/otel-specs-ja/spec/telemetry-stability/)
- [Entity Propagation](/works/otel-specs-ja/spec/entities/entity-propagation/)
- [Instrumentation Scope](/works/otel-specs-ja/spec/common/instrumentation-scope/)
- [Mappings](/works/otel-specs-ja/spec/profiles/mappings/)
- [OpenCensusとの互換性](/works/otel-specs-ja/spec/compatibility/opencensus/)
- [OpenTelemetry APIのパフォーマンスベンチマーク](/works/otel-specs-ja/spec/performance-benchmark/)
- [OpenTelemetryにおけるアップグレードの考え方](/works/otel-specs-ja/spec/upgrading/)
- [OpenTelemetry環境変数仕様](/works/otel-specs-ja/spec/configuration/sdk-environment-variables/)
- [OpenTracingとの互換性](/works/otel-specs-ja/spec/compatibility/opentracing/)
- [Pprof](/works/otel-specs-ja/spec/profiles/pprof/)
- [PrometheusとOpenMetricsとの互換性](/works/otel-specs-ja/spec/compatibility/prometheus_and_openmetrics/)
- [Propagators API](/works/otel-specs-ja/spec/context/api-propagators/)
- [TraceStateによる確率的サンプリング](/works/otel-specs-ja/spec/trace/tracestate-probability-sampling/)
- [TraceStateの取り扱い](/works/otel-specs-ja/spec/trace/tracestate-handling/)
- [コンテキスト伝搬のキャリアとしての環境変数](/works/otel-specs-ja/spec/context/env-carriers/)
- [セマンティック規約](/works/otel-specs-ja/spec/semantic-conventions/)
- [セマンティック規約におけるメトリクス要求レベル](/works/otel-specs-ja/spec/metrics/metric-requirement-level/)
- [プロファイルデータフォーマット](/works/otel-specs-ja/spec/profiles/data-format/)
- [ベンダー](/works/otel-specs-ja/spec/vendors/)
- [メトリクスAPIのNo-Op実装](/works/otel-specs-ja/spec/metrics/noop/)
- [メトリクスの補足ガイドライン](/works/otel-specs-ja/spec/metrics/supplementary-guidelines/)
- [ログAPIのNo-Op実装](/works/otel-specs-ja/spec/logs/noop/)
- [ログエクスポーター - 標準出力](/works/otel-specs-ja/spec/logs/sdk_exporters/stdout/)
- [ログのデータモデル付録](/works/otel-specs-ja/spec/logs/data-model-appendix/)
- [ログの補足ガイドライン](/works/otel-specs-ja/spec/logs/supplementary-guidelines/)
- [任意のデータをAnyValueへマッピングする](/works/otel-specs-ja/spec/common/attribute-type-mapping/)
- [例外](/works/otel-specs-ja/spec/trace/exceptions/)
- [共通設定仕様](/works/otel-specs-ja/spec/configuration/common/)
- [自己オブザーバビリティ 補足ガイドライン](/works/otel-specs-ja/spec/self-observability-supplementary-guidelines/)
- [設定の補足ガイドライン](/works/otel-specs-ja/spec/configuration/supplementary-guidelines/)
- [非OTLPログ形式におけるトレースコンテキスト](/works/otel-specs-ja/spec/compatibility/logging_trace_context/)
- [非OTLP形式へのマッピング](/works/otel-specs-ja/spec/common/mapping-to-non-otlp/)