Yoshi Yamaguchi

OpenTelemetryセマンティック規約

この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/

翻訳元: open-telemetry/semantic-conventions v1.44.0（コミット e10a930）

セマンティック規約は、テレメトリーデータを収集・生成・利用する際に意味を与える、共通の（セマンティックな）属性の集合を定義します。 セマンティック規約は、スパン名や種別、メトリクスの計測器や単位、属性名・型・意味・有効な値などについても規定します。 セマンティック規約が対象とする範囲の詳細な定義は、セマンティック規約の安定性を参照してください。 セマンティック規約に従う利点は、コードベースやライブラリ、プラットフォームをまたいで標準化できる共通の命名規則に従うことにあります。 これによって、データの関連付けや利用が容易になります。

セマンティック規約は、次の領域について定義されています。

  • General: 汎用のセマンティック規約。
  • CI/CD: CI/CDシステムのセマンティック規約。
  • クラウドプロバイダー: クラウドプロバイダーのライブラリのセマンティック規約。
  • CloudEvents: CloudEvents仕様のセマンティック規約。
  • Database: データベース操作のセマンティック規約。
  • Exceptions: 例外のセマンティック規約。
  • FaaS: Function as a Service（FaaS）操作のセマンティック規約。
  • Feature Flags: フィーチャーフラグ評価のセマンティック規約。
  • Generative AI: OpenTelemetry GenAI semantic conventionsリポジトリに移動しました。
  • GraphQL: GraphQL実装のセマンティック規約。
  • HTTP: HTTPクライアントとサーバーの操作のセマンティック規約。
  • Messaging: メッセージング操作とシステムのセマンティック規約。
  • Object Stores: オブジェクトストア操作のセマンティック規約。
  • RPC: RPCクライアントとサーバーの操作のセマンティック規約。
  • System: Systemのセマンティック規約。

シグナル別に定義されているセマンティック規約は、次のとおりです。

  • Events: イベントデータのセマンティック規約。
  • Logs: ログデータのセマンティック規約。
  • Metrics: メトリクスのセマンティック規約。
  • Profiles: プロファイルのセマンティック規約。
  • Resource: リソースのセマンティック規約。
  • Trace: トレースとスパンのセマンティック規約。

設定に関するセマンティック規約は、次のとおりです。

  • Configuration: セマンティック規約に関連する設定オプション。

関連情報は、次のとおりです。