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

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

Kubernetesの命名例外

Kubernetesのユーザーは、Kubernetes APIで使われる単一語のリソース名(replicasetstatefulsetdaemonsetreplicationcontrollerresourcequotaなど)に慣れています。テレメトリーデータでも同じ名前を使うことで、ユーザーはデータをおなじみのKubernetesの概念やコマンド(kubectl get replicasetなど)に対応付けやすくなります。

Kubernetesオブジェクトに関連するEntity、属性、メトリクスに名前を付ける際は、公式のKubernetes APIオブジェクト名にある単一語の形式をそのまま優先して使用してください(1対1で対応する場合は、APIにある既存の単一語の用語を借用します)。APIオブジェクト名の正式な一覧はKubernetes APIリファレンスドキュメントで確認できます。新しい用語やフィールドについては、一般的な命名に関する考慮事項に従ってください。

命名の推奨事項

  • Kubernetes APIオブジェクト名に1対1で対応するリソースについては、Kubernetes APIにある単一語の形式(アンダースコアを使わず、APIと同様に単語を連結した形式)をそのまま使用します。

Use:    k8s.replicaset.uid      (not k8s.replica_set.uid)
Use:    k8s.resourcequota.uid   (not k8s.resource_quota.uid)