Descripción general

Actualice cómo aparecen sus servicios en Datadog sin cambiar la configuración del rastreador ni volver a implementar código. Las reglas de Service Remapping le permiten renombrar, fusionar o dividir servicios; o crear nuevos servicios basados en etiquetas de infraestructura desde la interfaz de usuario de Datadog. También puede crear reglas de Service Remapping para otros tipos de entidades, como servicios inferidos, almacenes de datos y colas.

Requisitos previos

Debe tener el permiso APM Service Remapping Write (apm_service_renaming_write) para crear, editar y eliminar reglas de Service Remapping. Consulte Permisos para obtener detalles sobre el control de acceso basado en roles de Datadog.

Requisitos de versión del rastreador

Solo puede crear reglas de Service Remapping para servicios instrumentados con versiones de rastreador compatibles. Si un servicio está reportando desde una versión de rastreador anterior, actualice el SDK antes de crear reglas de Service Remapping para ese servicio.

Nota: Esto solo aplica a servicios instrumentados. No hay requisitos de versión de rastreador para remapear servicios inferidos, almacenes de datos o colas.

Cree una regla de Service Remapping

Paso 1: Seleccione la acción de Service Remapping y las entidades a las que apuntar

1. En Datadog, navegue a APM > Catalog > Manage > Service Remapping. Haga clic en Add Service Rule para aplicar Service Remapping a servicios instrumentados. Para aplicar Service Remapping a servicios inferidos, almacenes de datos o colas, seleccione la pestaña Inferred Entity Rules y haga clic en Add Inferred Entity Rule.

   Alternativamente, navegue a APM > Catalog y haga clic en un servicio para abrir el panel lateral del servicio. Desde ahí, haga clic en Service Page > Service Remapping.

2. Elija una acción de Service Remapping para realizar en su nueva regla de Service Remapping.

   • Seleccione Remap services para dividir una sola entidad, renombrar una entidad, combinar varias entidades o renombrar varias entidades.
   • Seleccione Correlate telemetry para identificar un servicio basado en una etiqueta de infraestructura.

3. Utilice la barra de búsqueda para seleccionar las entidades a las que desea aplicar Service Remapping.

   • Puede seleccionar una o más entidades, pero todas deben ser del mismo tipo (servicio, servicio inferido, almacén de datos o cola). Seleccione servicios basados en su etiqueta service o peer.service, no por sus metadatos de Display Name.
   • A medida que selecciona entidades, se crea una consulta de tramos en segundo plano. Para editar la consulta, seleccione Build Advanced Query.
   • Si está correlacionando un servicio con etiquetas de infraestructura, solo puede seleccionar un servicio. Elija la(s) etiqueta(s) de infraestructura para correlacionar la telemetría. Toda la telemetría con la(s) misma(s) etiqueta(s) de infraestructura que el servicio elegido se reasignará a un único nombre de servicio unificado.

Paso 2: Especifique el nuevo nombre de la entidad

En el cuadro de texto, ingrese un nombre único para la entidad (o entidades) seleccionada(s). Alternativamente, use valores de etiqueta con la sintaxis {{tagName}} para aplicar remapeo según las etiquetas de una entidad. A medida que escribe, aparece una vista previa del nuevo nombre (o nombres) de servicio.

1. Si los valores de etiqueta siguen un patrón, aplique una expresión regular para extraer solo la parte que desea en el nombre. Nota: La vista previa no es una lista exhaustiva. Si está reasignando un servicio basado en una etiqueta con varios valores, solo los valores con la mayor cantidad de tramos aparecerán en la vista previa.

Paso 3: Nombre su regla de Service Remapping y revise

1. Opcionalmente, ingrese un nombre descriptivo para la regla de Service Remapping para que pueda identificarla más tarde.
2. Revise y guarde su regla de Service Remapping. Después de guardar su regla de Service Remapping, puede tardar aproximadamente un minuto en surtir efecto.

Comportamiento de las reglas de Service Remapping

Las reglas de Service Remapping funcionan anulando la etiqueta service para remapear servicios, o la etiqueta peer.service para remapear servicios inferidos, almacenes de datos y colas. Los servicios se remapean en la ingesta, y cualquier configuración preexistente que especifique un nombre de servicio no cambia cuando se crea una regla de Service Remapping. Las reglas de Service Remapping tienen prioridad sobre todas las demás configuraciones de nombres de servicio.

Las reglas de Service Remapping se aplican en APM, registros, métricas, USM, DSM, DJM, DBM, creación de perfiles, NPM, Live Processes, Live Containers, Kubernetes y eventos.

• Datos históricos: Los cambios realizados por las reglas de Service Remapping afectan solo a la telemetría ingerida mientras una regla está activa, y los datos pasados no se actualizan retroactivamente. Eliminar o modificar una regla de Service Remapping impide que se aplique a datos nuevos, pero no revierte los nombres en los datos ingeridos previamente.
• Orden de las reglas: Las reglas de Service Remapping se aplican en orden. Las reglas en la parte superior de la lista de reglas se aplican primero. Un servicio se remapea únicamente mediante la primera regla que lo capture (no se aplican múltiples reglas al mismo servicio).
• Expresiones regulares: Se pueden usar expresiones regulares para definir nuevos nombres de servicio, pero no se permiten cuantificadores codiciosos dentro del grupo de captura.
• Remapeador del servicio de registros: Las reglas de Service Remapping se aplican antes que las canalizaciones de registros. Si tanto el rempaeador de servicios de registros como las reglas de Service Remapping se aplican a un servicio, las reglas de Service Remapping tienen prioridad.
• Dashboards y monitores: Las consultas existentes que hacen referencia a nombres de servicio antiguos no se actualizan automáticamente. Revíselas y actualícelas manualmente. Anulaciones de integración y personalizadas: Si las anulaciones de integración o las anulaciones personalizadas se encuentran dentro del contexto de una regla de Service Remapping, también se remapean. Elimine las anulaciones de integración para obtener la mejor experiencia de APM.
• Jerarquía de nombres de servicio: Los nombres de servicio se determinan mediante la siguiente jerarquía, de mayor a menor prioridad:
  1. Reglas de Service Remapping
  2. Servicio definido en el código (tracer.Start(WithService(xx)))
  3. Servicio definido en la propiedad del sistema (-Ddd.service={})
  4. Servicio definido en la variable de entorno (DD_SERVICE)
  5. Servicio definido en el archivo de configuración (application_monitoring.yaml)

Lecturas adicionales

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

Conecte de manera integral los datos de su servicio con Service RemappingBLOG