Reglas de reasignación para entidades inferidas

Este producto no es compatible con el sitio Datadog seleccionado. ().

Información general

En Datadog, puedes reasignar entidades inferidas, que incluyen los almacenes de datos y las colas, para que sean más fáciles de identificar y gestionar. Las reglas de reasignación permiten sustituir la etiqueta peer.service en tramos (spans) con nombres personalizados o generar nombres dinámicamente utilizando etiquetas y expresiones regulares. Esta funcionalidad se aplica en todo APM, no solo en el Software Catalog. Una vez creada una regla, los nombres actualizados aparecen de forma coherente en mapas de servicio, Trace Explorer, monitores, dashboards y cualquier otra vista de APM.

La reasignación es útil cuando:

  • El nombre por defecto no coincide con tus preferencias o convenciones.
  • Los servicios que esperas que aparezcan como uno solo se dividen en varias entidades inferidas.
  • Varios componentes están agrupados bajo un mismo nombre, pero quieres representarlos por separado.

Nota: Esta página describe solo la reasignación de entidades inferidas. Para reasignar tus servicios instrumentados (rastreados), está disponible la versión preliminar de Service Remapping Rules.

Requisitos previos

Debes tener el permiso apm_service_renaming_write para crear reglas de reasignación. Consulta Permisos para obtener más información sobre el control de acceso basado en roles de Datadog.

Crear una regla de reasignación

Paso 1: Seleccionar la acción y las entidades de reasignación objetivo

  1. En Datadog, ve a APM > Software Catalog > Manage > Manage Remapping Rules (APM > Software Catalog > Gestionar > Gestionar reglas de reasignación) y haz clic en + Add Rule (+ Añadir regla).

    Alternativamente, ve a APM > Software Catalog y haz clic en un servicio para abrir el panel lateral de servicios. Desde allí, haz clic en Service Page > Service Remapping (Página de servicio > Reasignación de servicios).

    Panel lateral de un servicio concreto que muestra el menú desplegable de la página de servicio con una opción de reasignación de servicios

  2. Elige una acción de reasignación que quieras realizar para tu nueva regla de reasignación.

    Puedes optar por dividir una única entidad, renombrar una entidad, fusionar varias entidades o reasignar varias entidades.

  3. Utiliza la barra de búsqueda para seleccionar las entidades que quieres reasignar.

    • Puedes seleccionar una o varias entidades, pero todas deben ser del mismo tipo (servicio, almacén de datos o cola).
    • A medida que seleccionas entidades, se crea una consulta de tramo en segundo plano. Para editar la consulta, selecciona Build Advanced Query (Crear consulta avanzada).

Paso 2: Especificar el nombre de la nueva entidad

  1. En el cuadro de texto, introduce un nombre único para la entidad (o entidades) seleccionada. Alternativamente, utiliza valores de etiqueta con la sintaxis {{tagName}} para reasignar en función de las etiquetas de una entidad.
  2. Si los valores de las etiquetas siguen un patrón, aplica una expresión regular para extraer solo la parte que quieras del nombre.

Paso 3: Colocarle un nombre a tu regla y revisarla

  1. Puedes introducir un nombre descriptivo para la regla de reasignación a fin de poder identificarla posteriormente.
  2. Revisa y guarda tu regla de reasignación.
  • Las reglas se procesan en la ingesta y se aplican a los datos a medida que se reciben.
  • Los cambios solo afectan a los tramos en los que la regla está activa y los datos anteriores no se actualizan de forma retroactiva.
  • La eliminación o modificación de una regla impide que se aplique a los nuevos datos, pero no revierte los nombres de los datos ingeridos anteriormente.

Referencias adicionales

Más enlaces, artículos y documentación útiles:

Servicios inferidosDOCUMENTACIÓN more more