Kubernetesアノテーションによるリソース属性の指定

resource.opentelemetry.io/という接頭辞を持つすべてのアノテーションは、対応するリソース属性へ変換すべきです（SHOULD）。

例えば、アノテーションresource.opentelemetry.io/service.nameはservice.name属性へ変換すべきです（SHOULD）。

サービス属性

Kubernetesのサービスに対しては、以下のサービスリソース属性を推奨します。

サービス属性の計算方法には、いくつかの種類があります。

この変換は通常、Kubernetes Attribute ProcessorのようなOpenTelemetry Collectorコンポーネントによって行えます。

この機能を提供するツールは、well-known labelsの使用に対するオプトインフラグを用意すべきです。ユーザーが自分のラベルがこの目的で使われていることに気づいていない場合があるためです。

それぞれの属性には、以下で説明するように、どのように計算すべきかについての優先順位があります。

見つかった最初の値を選択します。

見つかった最初の値を選択します。

pod.annotation[resource.opentelemetry.io/service.name]
pod.label[app.kubernetes.io/instance]（well-known labelの app.kubernetes.io/instance）
pod.label[app.kubernetes.io/name]（well-known labelの app.kubernetes.io/name）
k8s.deployment.name
k8s.replicaset.name
k8s.statefulset.name
k8s.daemonset.name
k8s.cronjob.name
k8s.job.name
k8s.pod.name
k8s.container.name

この優先順位の考え方は、Kubernetesのリソース階層において祖先から子孫へ、例えばdeploymentからpodへと辿ることです。Kubernetes Object Hierarchyを参照してください。

見つかった最初の値を選択します。

pod.annotation[resource.opentelemetry.io/service.version]
pod.label[app.kubernetes.io/version]（well-known labelの app.kubernetes.io/version）
以下で説明するアルゴリズムを使ってバージョンを計算する

見つかった最初の値を選択します。

なお、コンテナの再起動回数はservice.instance.idの計算には含まれません。クラッシュループのように再起動ごとにIDが変わってしまうと、トラブルシューティングが難しくなるためです。