Información general

Datadog puede descubrir automáticamente las dependencias para un servicio instrumentado, como una base de datos, una cola o una API de terceros, incluso si esa dependencia aún no se ha instrumentado. Mediante el análisis de las solicitudes salientes de tus servicios instrumentados, Datadog infiere la presencia de estas dependencias y recopila las métricas de rendimiento asociado.

Con la nueva experiencia de entidades inferidas, puedes filtrar las entradas del Catálogo de servicios por tipo de entidad, como base de datos, cola o API de terceros. Esto te permite visualizar mejor las dependencias de servicio utilizando el mapa de dependencias de la Página de servicios y funciones de APM.

Para determinar los nombres y tipos de las dependencias de servicio inferidas, Datadog utiliza atributos de tramo estándar y los asigna a atributos peer.*. Para consultar la lista completa de atributos peer.*, consulta Nomenclatura de dependencias de servicio inferidas. Las API externas inferidas utilizan el esquema de nomenclatura por defecto net.peer.name. Por ejemplo, api.stripe.com, api.twilio.com, us6.api.mailchimp.com. Las bases de datos inferidas utilizan el esquema de nomenclatura por defecto db.instance.

Si utilizas el rastreador de Go, Java, Node.js, PHP, .NET o Ruby, puedes personalizar los nombres predeterminados de las entidades inferidas.

Nota: Si configuras monitores, dashboards, o notebooks para un determinado servicio inferido durante la fase beta, puede que necesites actualizarlos si el esquema de nombres cambia. Más información sobre los pasos de migración en las instrucciones de elección.

Mapa de dependencia de la Página de servicios

Utiliza el mapa de dependencias para visualizar la comunicación servicio a servicio y obtener información sobre componentes del sistema como bases de datos, colas y dependencias de terceros. Puedes agrupar las dependencias por tipo y filtrarlas por solicitudes, latencia o errores para identificar conexiones lentas o con fallos.

Elección

Para elegir, Datadog te recomienda que ajustes tu:

• Configuración del Datadog Agent (o Collector de OpenTelemetry)
• Configuración de bibliotecas de rastreo de APM

Configuración del Datadog Agent

Requisitos:

• Datadog Agent versión >= 7.50.3.

Actualiza tu archivo de configuración datadog.yaml con lo siguiente:

apm_config:
  compute_stats_by_span_kind: true
  peer_tags_aggregation: true
  peer_tags: ["_dd.base_service","amqp.destination","amqp.exchange","amqp.queue","aws.queue.name","aws.s3.bucket","bucketname","cassandra.keyspace","db.cassandra.contact.points","db.couchbase.seed.nodes","db.hostname","db.instance","db.name","db.namespace","db.system","grpc.host","hostname","http.host","http.server_name","messaging.destination","messaging.destination.name","messaging.kafka.bootstrap.servers","messaging.rabbitmq.exchange","messaging.system","mongodb.db","msmq.queue.path","net.peer.name","network.destination.name","peer.hostname","peer.service","queuename","rpc.service","rpc.system","server.address","streamname","tablename","topicname"]

Alternativamente, configura esto estableciendo las siguientes variables de entorno en tu configuración de lanzamiento de Datadog Agent:

DD_APM_COMPUTE_STATS_BY_SPAN_KIND=true 
DD_APM_PEER_TAGS_AGGREGATION=true
DD_APM_PEER_TAGS='["_dd.base_service","amqp.destination","amqp.exchange","amqp.queue","aws.queue.name","aws.s3.bucket","bucketname","cassandra.keyspace","db.cassandra.contact.points","db.couchbase.seed.nodes","db.hostname","db.instance","db.name","db.namespace","db.system","grpc.host","hostname","http.host","http.server_name","messaging.destination","messaging.destination.name","messaging.kafka.bootstrap.servers","messaging.rabbitmq.exchange","messaging.system","mongodb.db","msmq.queue.path","net.peer.name","network.destination.name","peer.hostname","peer.service","queuename","rpc.service","rpc.system","server.address","streamname","tablename","topicname"]'

Helm

Incluye el mismo conjunto de variables de entorno en tu archivo values.yaml.

Collector de OpenTelemetry

Versión mínima recomendada: opentelemetry-collector-contrib >= v0.95.0.

Ejemplo collector.yaml.

connectors:
  datadog/connector:
    traces:
      compute_stats_by_span_kind: true
      peer_tags_aggregation: true
      peer_tags: ["_dd.base_service","amqp.destination","amqp.exchange","amqp.queue","aws.queue.name","aws.s3.bucket","bucketname","db.cassandra.contact.points","db.couchbase.seed.nodes","db.hostname","db.instance","db.name","db.namespace","db.system","grpc.host","hostname","http.host","http.server_name","messaging.destination","messaging.destination.name","messaging.kafka.bootstrap.servers","messaging.rabbitmq.exchange","messaging.system","mongodb.db","msmq.queue.path","net.peer.name","network.destination.name","peer.hostname","peer.service","queuename","rpc.service","rpc.system","server.address","streamname","tablename","topicname"]

Si tu versión del Collector es inferior a v0.95.0, utiliza una configuración de exportador con las siguientes peer_tags:

exporters:
  datadog:
    traces:
      compute_stats_by_span_kind: true
      peer_tags_aggregation: true
      peer_tags: ["_dd.base_service","amqp.destination","amqp.exchange","amqp.queue","aws.queue.name","aws.s3.bucket","bucketname","db.cassandra.contact.points","db.couchbase.seed.nodes","db.hostname","db.instance","db.name","db.namespace","db.system","grpc.host","hostname","http.host","http.server_name","messaging.destination","messaging.destination.name","messaging.kafka.bootstrap.servers","messaging.rabbitmq.exchange","messaging.system","mongodb.db","msmq.queue.path","net.peer.name","network.destination.name","peer.hostname","peer.service","queuename","rpc.service","rpc.system","server.address","streamname","tablename","topicname"]   

Configuración de la biblioteca de rastreo de APM

La nueva nomenclatura: qué cambia

Lista de etiquetas de peer.* recién introducidas

Migración de nomenclatura del servicio global por defecto

Al activar la variable de entorno DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED, se mejora la representación de las conexiones servicio a servicio y los servicios inferidos en las visualizaciones de Datadog, en todos los lenguajes de biblioteca de rastreo e integraciones compatibles.

Anteriormente, algunas bibliotecas de rastreo incluían el nombre de integración asociada en el etiquetado de nombre de servicio. Por ejemplo, .NET etiquetaba las llamadas gRPC como service:<DD_SERVICE>-grpc-client mientras que Python las etiquetaba como service:grpc-client. Con esta opción activada, todos los tramos de etiqueta de bibliotecas de rastreo compatibles de los servicios de descarga con el nombre del servicio de llamada, service:<DD_SERVICE>, proporcionando así un nombre de servicio global predeterminado.

Del mismo modo, para un tramo que representa una llamada a una base de datos mySQL:

En consecuencia, si tienes:

• Métricas de APM
• Métricas de tramo personalizadas de APM
• Análisis de traza
• Filtros de retención
• Escaneos de datos confidenciales
• Monitores, dashboards, o notebooks

Y estos apuntan a nombres de servicio similares, actualiza esos elementos para utilizar la etiqueta de servicio predeterminado global (service:<DD_SERVICE>) en su lugar.

Leer más

Additional helpful documentation, links, and articles:

Observabilidad del servicioDOCUMENTACIÓN Envío de trazas a DatadogDOCUMENTACIÓN Añadir la biblioteca de rastreo de DatadogDOCUMENTACIÓN