Servicios inferidos

Documentación > APM > Observabilidad del servicio > Servicios inferidos

Descripción general

Datadog descubre automáticamente las dependencias de un servicio instrumentado, como bases de datos, colas o API de terceros, incluso si esa dependencia no ha sido instrumentada directamente. Al analizar las solicitudes salientes de sus servicios instrumentados, Datadog infiere la presencia de estas dependencias y recopila métricas de rendimiento asociadas.

Mapa de dependencias de la página de servicio

Explore los servicios inferidos en el Catálogo filtrando las entradas por tipo de entidad, como bases de datos, colas o API de terceros. Cada página de servicio está adaptada al tipo de servicio que está investigando. Por ejemplo, la página de servicio de base de datos muestra información específica de la base de datos e incluye datos de monitoreo de base de datos si está utilizando Database Monitoring.

Configurar servicios inferidos

A partir de la versión 7.60.0 del Datadog Agent, no se necesita configuración manual para ver los servicios inferidos. Las configuraciones requeridas—apm_config.compute_stats_by_span_kind y apm_config.peer_tags_aggregation—están habilitadas de forma predeterminada.

Para las versiones 7.55.1 a 7.59.1 del Datadog Agent, agregue lo siguiente a su archivo de configuración datadog.yaml:

datadog.yaml

apm_config:
  compute_stats_by_span_kind: true
  peer_tags_aggregation: true

Alternativamente, establezca estas variables de entorno en la configuración de su Datadog Agent:

DD_APM_COMPUTE_STATS_BY_SPAN_KIND=true 
DD_APM_PEER_TAGS_AGGREGATION=true

Si utiliza Helm, incluya estas variables de entorno en su values.yaml archivo.

Para las versiones 7.50.3 a 7.54.1 del Datadog Agent, agregue lo siguiente a su archivo de configuración datadog.yaml:

datadog.yaml

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, establezca estas variables de entorno en la configuración de su 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"]'

Si utiliza Helm, incluya estas variables de entorno en su values.yaml archivo.

Para OpenTelemetry Collector, la versión mínima recomendada es opentelemetry-collector-contrib v0.95.0 o posterior. En ese caso, actualice esta configuración:

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 su versión de Collector es anterior a la v0.95.0, actualice la siguiente configuración de Collector:

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"]   

Ejemplo: collector.yaml.

Asignación de nombres a entidades inferidas

Para determinar los nombres y tipos de las dependencias de servicio inferidas, Datadog utiliza atributos de tramo estándar y los asigna a atributos de peer.*. Por ejemplo, las API externas inferidas utilizan el esquema de nombres predeterminado net.peer.name como api.stripe.com, api.twilio.com y us6.api.mailchimp.com. Las bases de datos inferidas utilizan el esquema de nombres predeterminado db.instance. Puede cambiar el nombre de las entidades inferidas creando reglas de cambio de nombre.

Etiquetas de pares

Etiqueta de par	Atributos de fuente
`peer.aws.dynamodb.table`	`tablename`
`peer.aws.kinesis.stream`	`streamname`
`peer.aws.s3.bucket`	`bucketname`, `aws.s3.bucket`
`peer.aws.sqs.queue`	`queuename`
`peer.cassandra.contact.points`	`db.cassandra.contact.points`
`peer.couchbase.seed.nodes`	`db.couchbase.seed.nodes`
`peer.db.name`	`db.name`, `mongodb.db`, `db.instance`, `cassandra.keyspace`, `db.namespace`
`peer.db.system`	`db.system`
`peer.hostname`	`peer.hostname`, `hostname`, `net.peer.name`, `db.hostname`, `network.destination.name`, `grpc.host`, `http.host`, `server.address`, `http.server_name`
`peer.kafka.bootstrap.servers`	`messaging.kafka.bootstrap.servers`
`peer.messaging.destination`	`topicname`, `messaging.destination`, `messaging.destination.name`, `messaging.rabbitmq.exchange`, `amqp.destination`, `amqp.queue`, `amqp.exchange`, `msmq.queue.path`, `aws.queue.name`
`peer.messaging.system`	`messaging.system`
`peer.rpc.service`	`rpc.service`
`peer.rpc.system`	`rpc.system`
`peer.service`	`peer.service`

Nota: Los valores de los atributos de pares que coinciden con formatos de dirección IP se modifican y redactan con blocked-ip-address para evitar ruido innecesario y métricas de etiquetado con dimensiones de alta cardinalidad. Como resultado, es posible que encuentre algunos blocked-ip-address servicios que aparecen como dependencias descendentes de sus servicios instrumentados.

Precedencia de etiquetas de pares

Para asignar el nombre a las entidades inferidas, Datadog utiliza un orden de precedencia específico entre las etiquetas de pares, cuando las entidades se definen mediante una combinación de varias etiquetas.

Tipo de entidad	Orden de precedencia
Base de datos	`peer.db.name` > `peer.aws.s3.bucket` (Para AWS S3) / `peer.aws.dynamodb.table` (Para AWS DynamoDB) / `peer.cassandra.contact.points` (Para Cassandra) / `peer.couchbase.seed.nodes` (Para Couchbase) > `peer.hostname` > `peer.db.system`
Cola	`peer.messaging.destination` > `peer.kafka.bootstrap.servers` (para Kafka) / `peer.aws.sqs.queue` (para AWS SQS) / `peer.aws.kinesis.stream` (Para AWS Kinesis) > `peer.messaging.system`
Servicio inferido	`peer.service` > `peer.rpc.service` > `peer.hostname`

Si la etiqueta de mayor prioridad, como peer.db.name, no se captura como parte de la instrumentación, Datadog utiliza la segunda etiqueta de mayor prioridad, como peer.hostname, y continúa en ese orden.

Nota: Datadog nunca establece el peer.service para bases de datos y colas inferidas. peer.service es el atributo de par de mayor prioridad. Si se establece, tiene prioridad sobre todos los demás atributos.

Migrar a la nomenclatura de servicio predeterminada global

Con los servicios inferidos, las dependencias de servicio se detectan automáticamente a partir de los atributos de tramo existentes. Como resultado, no es necesario cambiar los nombres de servicio (usando la etiqueta service) para identificar estas dependencias.

Habilite DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED para asegurarse de que ninguna integración de Datadog establezca nombres de servicio que sean diferentes al nombre de servicio global predeterminado. Esto también mejora la forma en que las conexiones de servicio a servicio y los servicios inferidos se representan en las visualizaciones de Datadog, en todos los lenguajes de SDK e integraciones compatibles.

Habilitar esta opción puede afectar las métricas de APM existentes, las métricas de tramo personalizadas, el análisis de trazas, los filtros de retención, los escaneos de datos confidenciales, los monitores, los paneles o los cuadernos que hacen referencia a los nombres de servicio antiguos. Actualice estos activos para usar la etiqueta de servicio predeterminada global (service:<DD_SERVICE>).

Para obtener instrucciones sobre cómo eliminar las anulaciones de servicio y migrar a servicios inferidos, consulte la guía de Anulaciones de servicio.