OpenTelemetry Semantic Conventions and Datadog Conventions

문서 > OpenTelemetry in Datadog > Schema and Semantics > OpenTelemetry Semantic Conventions and Datadog Conventions

이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.

OpenTelemetry makes use of a number of semantic conventions that specify names for different types of data. This page lists mappings for OpenTelemetry semantic conventions to Datadog’s semantic conventions.

Unified service tagging

OpenTelemetry convention	Datadog convention
`deployment.environment` ¹	`env`
`deployment.environment.name` ²	`env`
`service.name`	`service`
`service.version`	`version`

For more information, see Unified Service Tagging.

1: deployment.environment has been deprecated in favor of deployment.environment.name in OpenTelemetry semantic conventions v1.27.0
2: deployment.environment.name is supported in Datadog Agent 7.58.0+ and Datadog Exporter v0.110.0+

Containers

OpenTelemetry convention	Datadog convention
`container.id`	`container_id`
`container.name`	`container_name`
`container.image.name`	`image_name`
`container.image.tag`	`image_tag`

Additional cloud provider-specific attributes are also mapped.

Cloud

OpenTelemetry convention	Datadog convention
`cloud.provider`	`cloud_provider`
`cloud.region`	`region`
`cloud.availability_zone`	`zone`

ECS

OpenTelemetry convention	Datadog convention
`aws.ecs.task.family`	`task_family`
`aws.ecs.task.arn`	`task_arn`
`aws.ecs.cluster.arn`	`ecs_cluster_name`
`aws.ecs.task.revision`	`task_version`
`aws.ecs.container.arn`	`ecs_container_name`

Kubernetes

OpenTelemetry convention	Datadog convention
`k8s.container.name`	`kube_container_name`
`k8s.cluster.name`	`kube_cluster_name`
`k8s.deployment.name`	`kube_deployment`
`k8s.replicaset.name`	`kube_replica_set`
`k8s.statefulset.name`	`kube_stateful_set`
`k8s.daemonset.name`	`kube_daemon_set`
`k8s.job.name`	`kube_job`
`k8s.cronjob.name`	`kube_cronjob`
`k8s.namespace.name`	`kube_namespace`
`k8s.pod.name`	`pod_name`

Kubernetes labels

Kubernetes convention	Datadog convention
`app.kubernetes.io/name`	`kube_app_name`
`app.kubernetes.io/instance`	`kube_app_instance`
`app.kubernetes.io/version`	`kube_app_version`
`app.kuberenetes.io/component`	`kube_app_component`
`app.kubernetes.io/part-of`	`kube_app_part_of`
`app.kubernetes.io/managed-by`	`kube_app_managed_by`

HTTP

OpenTelemetry convention	Datadog convention
`client.address`	`http.client_ip`
`http.response.body.size`	`http.response.content_length`
`http.response.header.<header-name>`	`http.response.headers.<header-name>`
`http.response.status_code`	`http.status_code`
`http.request.body.size`	`http.request.content_length`
`http.request.header.referrer`	`http.referrer`
`http.request.header.<header-name>`	`http.request.headers.<header-name>`
`http.request.method`	`http.method`
`http.route`	`http.route`
`network.protocol.version`	`http.version`
`server.address`	`http.server_name`
`url.full`	`http.url`
`user_agent.original`	`http.useragent`

Metrics attribute mapping

For metrics, by default, Datadog only maps the OpenTelemetry resource attributes listed in the previous sections to Datadog metric tags. To map all resource attributes to tags, enable the metrics::resource_attributes_as_tags setting:

exporters:
  datadog:
    # Other configuration goes here...
    metrics:
      # Add all resource attributes as tags for metrics
      resource_attributes_as_tags: true

otlp_config:
  # Other configuration goes here...
  metrics:
    # Add all resource attributes as tags for metrics
    resource_attributes_as_tags: true