Conventions sémantiques OpenTelemetry et conventions Datadog

Documentation > OpenTelemetry dans Datadog > Semantic Mapping > Conventions sémantiques OpenTelemetry et conventions Datadog

OpenTelemetry utilise des conventions sémantiques qui spécifient des noms pour différents types de données. Cette page répertorie les mappages des conventions sémantiques OpenTelemetry vers les conventions sémantiques de Datadog.

Convention OpenTelemetry	Convention Datadog	Type
`deployment.environment.name` ^*	`env`	Unified service tagging
`service.name`	`service`	Unified service tagging
`service.version`	`version`	Unified service tagging
`container.id`	`container_id`	Containers
`container.name`	`container_name`	Containers
`container.image.name`	`image_name`	Containers
`container.image.tag`	`image_tag`	Containers
`cloud.provider`	`cloud_provider`	Cloud
`cloud.region`	`region`	Cloud
`cloud.availability_zone`	`zone`	Cloud
`aws.ecs.task.family`	`task_family`	ECS
`aws.ecs.task.arn`	`task_arn`	ECS
`aws.ecs.cluster.arn`	`ecs_cluster_name`	ECS
`aws.ecs.task.revision`	`task_version`	ECS
`aws.ecs.container.arn`	`ecs_container_name`	ECS
`k8s.container.name`	`kube_container_name`	Kubernetes
`k8s.cluster.name`	`kube_cluster_name`	Kubernetes
`k8s.deployment.name`	`kube_deployment`	Kubernetes
`k8s.replicaset.name`	`kube_replica_set`	Kubernetes
`k8s.statefulset.name`	`kube_stateful_set`	Kubernetes
`k8s.daemonset.name`	`kube_daemon_set`	Kubernetes
`k8s.job.name`	`kube_job`	Kubernetes
`k8s.cronjob.name`	`kube_cronjob`	Kubernetes
`k8s.namespace.name`	`kube_namespace`	Kubernetes
`k8s.pod.name`	`pod_name`	Kubernetes
`app.kubernetes.io/name`	`kube_app_name`	Kubernetes labels
`app.kubernetes.io/instance`	`kube_app_instance`	Kubernetes labels
`app.kubernetes.io/version`	`kube_app_version`	Kubernetes labels
`app.kubernetes.io/component`	`kube_app_component`	Kubernetes labels
`app.kubernetes.io/part-of`	`kube_app_part_of`	Kubernetes labels
`app.kubernetes.io/managed-by`	`kube_app_managed_by`	Kubernetes labels
`client.address`	`http.client_ip`	HTTP
`http.response.body.size`	`http.response.content_length`	HTTP
`http.response.header.<header-name>`	`http.response.headers.<header-name>`	HTTP
`http.response.status_code`	`http.status_code`	HTTP
`http.request.body.size`	`http.request.content_length`	HTTP
`http.request.header.referrer`	`http.referrer`	HTTP
`http.request.header.<header-name>`	`http.request.headers.<header-name>`	HTTP
`http.request.method`	`http.method`	HTTP
`http.route`	`http.route`	HTTP
`network.protocol.version`	`http.version`	HTTP
`server.address`	`http.server_name`	HTTP
`url.full`	`http.url`	HTTP
`user_agent.original`	`http.useragent`	HTTP

^*Remplace la convention deployment.environment obsolète. Nécessite Datadog Agent 7.58.0+, l’exportateur Datadog v0.110.0+ ou l’ingestion OTLP Datadog.

Mappage du type de span

Datadog utilise une convention spécifique au fournisseur de « type de span » représentée par l’attribut span.type.

En fonction des attributs inclus dans votre span, le Datadog Agent et les composants OpenTelemetry de Datadog tentent de déduire le type de span approprié pour une meilleure compatibilité avec les autres services Datadog. Vous pouvez également définir explicitement l’attribut span.type sur n’importe quel span pour remplacer cette logique en utilisant un processeur attributes ou transform, ainsi qu’en définissant des valeurs de configuration appropriées dans les SDK OpenTelemetry.

Mappez l’attribut de span OpenTelemetry vers le type de span Datadog

Le tableau suivant présente la logique de mappage du type de span. Le tableau répertorie les mappages par ordre de priorité.

#	Attribut de span	span.type Datadog
1	`span.type`	`span.type` valeur d’attribut
2	Type de span serveur	`web`
3	Type de span client	voir 3a/b
3a	Type de span client, `db.system` attribut non trouvé	`http`
3b	Type de span client, `db.system` attribut trouvé	Voir le tableau ci-dessous Mappage du type de système de base de données OpenTelemetry vers le type de span Datadog
4	Aucune des conditions ci-dessus n’a été remplie	`custom`

Mappage du type de système de base de données OpenTelemetry vers le type de span Datadog

Dans le tableau ci-dessus, si un span est de type « client » et contient un db.system attribut, le mappage suivant s’applique au type de span dans Datadog. La définition d’un attribut span.type sur votre span remplace cette logique.

`db.system`	Datadog span.type
Type SQL de SGBD (listé ci-dessous)	`sql`
`adabas`	`sql`
`cache`	`sql`
`clickhouse`	`sql`
`cloudscape`	`sql`
`cockroachdb`	`sql`
`coldfusion`	`sql`
`db2`	`sql`
`derby`	`sql`
`edb`	`sql`
`firebird`	`sql`
`firstsql`	`sql`
`filemaker`	`sql`
`hanadb`	`sql`
`h2`	`sql`
`hsqldb`	`sql`
`informix`	`sql`
`ingres`	`sql`
`instantdb`	`sql`
`interbase`	`sql`
`mariadb`	`sql`
`maxdb`	`sql`
`mssql`	`sql`
`mysql`	`sql`
`netezza`	`sql`
`oracle`	`sql`
`other_sql`	`sql`
`pervasive`	`sql`
`pointbase`	`sql`
`postgresql`	`sql`
`progress`	`sql`
`redshift`	`sql`
`sqlite`	`sql`
`sybase`	`sql`
`teradata`	`sql`
`vertica`	`sql`
Autres types de bases de données	voir ci-dessous
`cassandra`	`cassandra`
`couchbase`	`db`
`couchdb`	`db`
`cosmosdb`	`db`
`dynamodb`	`db`
`elasticsearch`	`elasticsearch`
`geode`	`db`
`hive`	`db`
`memcached`	`memcached`
`mongodb`	`mongodb`
`opensearch`	`opensearch`
`redis`	`redis`
toute `db.system` valeur non listée ci-dessus	`db`

Mappage des attributs de métriques

Par défaut, Datadog mappe uniquement les attributs de ressource OpenTelemetry listés dans le tableau des conventions sémantiques ci-dessus vers des tags de métriques Datadog.

Pour associer tous les attributs de ressource de vos charges utiles de métriques OTLP en tant que tags, activez le paramètre metrics::resource_attributes_as_tags : Une fois activé, ce paramètre ajoute toutes les paires key:value d’attributs de ressource en tant que tags Datadog, en plus des tags de conventions sémantiques mappés présentés dans le tableau ci-dessus.

Remarque : L’activation de cette option peut augmenter considérablement la cardinalité des tags. Pour vérifier quels tags sont ajoutés, inspectez vos métriques dans le Metrics Explorer.

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