Descripción general

Utilice reglas de enriquecimiento de etiquetas para agregar etiquetas a sus registros, spans de APM y métricas de traza sin cambios de código ni nuevas implementaciones. Puede utilizar valores de los metadatos de servicio que ya haya definido en el Catálogo, el valor de otra etiqueta o un valor fijo.

Requisitos previos

Debe tener el rol Datadog Admin para crear reglas de enriquecimiento de etiquetas. Consulte Control de acceso basado en roles para obtener más detalles.

Crear una regla de enriquecimiento de etiquetas

Reglas de enriquecimiento de etiquetas predeterminadas

Para habilitar una regla predeterminada, navegue a IDP > Manage > Tag Enrichment y active la regla predeterminada para team o system en la parte inferior de la página.

Habilitar una regla predeterminada aplica team o system a toda la telemetría de los servicios según los metadatos de entidad definidos en IDP. Solo se enriquecen los servicios con metadatos de entidad completados. Las etiquetas se agregan solo cuando la telemetría del servicio aún no tiene un valor para esa etiqueta.

Reglas de enriquecimiento de etiquetas personalizadas

Las reglas personalizadas le permiten dirigirse a un conjunto específico de servicios y configurar exactamente cómo se obtiene y aplica cada valor de etiqueta.

1. En Datadog, navegue a IDP > Manage > Tag Enrichment y haga clic en + Add Rule.
2. Seleccione las entidades que desea enriquecer. A medida que selecciona entidades, se crea una consulta en segundo plano. Para editar la consulta, seleccione Build Advanced Query.
   • Seleccione Add Condition para agregar una condición AND a su consulta.
   • Agregue múltiples valores en el campo Value para crear una condición OR.
3. Elija etiquetas y métodos de enriquecimiento:
   • Seleccione la etiqueta team, la etiqueta system, la etiqueta custom o varias.
   • Para cada etiqueta, seleccione si el valor de la etiqueta proviene de Metadatos de entidad, el valor de una etiqueta diferente o un valor fijo.
   • Elija si el valor se aplica solo cuando aún no existe, o si se agrega a la lista actual de valores para esa etiqueta.
4. De forma predeterminada, las etiquetas se agregan solo cuando falta el valor para un elemento de telemetría determinado.
5. Opcionalmente, ingrese un nombre descriptivo para la regla.
6. Revise y guarde su regla. Después de guardar la regla, puede tomar hasta una hora para que el enriquecimiento se aplique completamente a la telemetría entrante.

Agregar una regla de enriquecimiento de etiquetas desde una página de servicio

En cualquier página de servicio a la que le falte una etiqueta team o system, haga clic en Service Config para abrir el panel lateral de configuración. Un banner en la parte superior del panel indica qué etiquetas faltan.

Haga clic en Add Tags para abrir el modal de regla de enriquecimiento de etiquetas precargado con ese servicio.

Comportamiento de enriquecimiento de etiquetas

• Telemetría afectada: El enriquecimiento de etiquetas se aplica solo a registros, spans de APM y métricas de traza. Debido a que Data Observability: Jobs Monitoring envía telemetría de trabajos como spans de APM, esa telemetría también se enriquece, pero las métricas de Jobs Monitoring no. El enriquecimiento de etiquetas no es compatible con otros tipos de telemetría, incluyendo métricas personalizadas y de infraestructura, Database Monitoring, perfiles, Kubernetes, Universal Service Monitoring y eventos.
• Datos históricos: Las reglas de enriquecimiento de etiquetas se aplican únicamente a la telemetría ingerida mientras una regla está activa. Los datos anteriores no se actualizan de forma retroactiva. Eliminar o modificar una regla impide que se aplique a telemetría nueva, pero no actualiza los datos ingeridos previamente.
• Actualizaciones de metadatos: Actualizar o agregar metadatos de entidad a los servicios mientras las reglas de enriquecimiento están habilitadas, incluyendo las reglas predeterminadas, actualiza automáticamente esas etiquetas.
• Orden de procesamiento de reglas: Las reglas de enriquecimiento de etiquetas se aplican en el orden en que fueron creadas. Las reglas en la parte superior de la lista tienen prioridad sobre las reglas que se encuentran debajo de ellas.
• Interacción con reglas de reasignación: Las reglas de enriquecimiento de etiquetas se aplican después de las reglas de reasignación de servicio. Si una regla de reasignación de servicio modifica la etiqueta service, el enriquecimiento utiliza el nombre de servicio actualizado al buscar metadatos de IDP.
• Etiquetas primarias El enriquecimiento de etiquetas se aplica después de la resolución de las etiquetas primarias, por lo que las etiquetas enriquecidas no pueden utilizarse como etiquetas primarias.

Lecturas adicionales

Documentación, enlaces y artículos útiles adicionales:

Reglas de Service RemappingDOCUMENTACIÓN CatalogDOCUMENTACIÓN