En esta page (página) se explica cómo eliminar las sustituciones de integración, que utilizan nombres de servicio específicos de integración para representar llamadas a otros servicios. Para obtener más información conceptual, consulta Servicio base, sustituciones de integración y sustituciones de servicio y Servicios inferidos.

Requisitos previos

Antes de eliminar las sustituciones de integración:

1. Debes contar con el permiso de apm_service_renaming_write.
2. Tu versión del kit de desarrollo de software (SDK) de Datadog debe admitir la eliminación de sustituciones. Consulta los requisitos de la versión del kit de desarrollo de software (SDK).

Requisitos de la versión del kit de desarrollo de software (SDK)

Eliminar sustituciones de integración

Para eliminar las sustituciones de integración en Datadog:

1. Ve a Software Catalog (Catálogo de software) > Manage (Gestionar) > Manage Remapping Rules (Gestionar reglas de reasignación) y haz clic en Manage Overrides (Gestionar sustituciones).

2. Para cada sustitución que desees eliminar, revisa los monitores y dashboards relacionados.

   Estos activos hacen referencia al nombre de servicio sustituido y dejan de coincidir tras su eliminación. Actualízalos para que utilicen el nombre de servicio base (service:<DD_SERVICE>) para conservar la funcionalidad.

3. Elimina las sustituciones individualmente o en bloque:

   • Seleccionar sustituciones específicas para eliminar: Selecciona las sustituciones de integración que desees eliminar. En una barra de Migration Progress (Progreso de la migración) se muestra el progreso a medida que se eliminan las sustituciones.
   • Eliminar todas las sustituciones: Selecciona Finish Migration (Finalizar migración) para eliminar todas las sustituciones de integración y evitar que aparezcan otras en el futuro a medida que aumente el uso de APM. Las sustituciones de servicios personalizados no se ven afectadas.

   La eliminación de sustituciones es reversible.

Ejemplos: Nomenclatura de servicios tras la eliminación

La eliminación de las sustituciones de integración cambia el modo en que se etiquetan los spans (tramos) de cliente y en que se identifican las dependencias descendentes. Una vez eliminadas las sustituciones, los spans (tramos) de cliente utilizan el nombre del servicio de llamada (service:<DD_SERVICE>) en lugar del nombre específico de la integración. La dependencia llamada se identifica mediante atributos de peer.* (por ejemplo, base de datos o cola).

ejemplo de gRPC:

Ejemplo de MySQL:

Eliminación basada en la configuración

También puedes eliminar las sustituciones de integración estableciendo una variable de entorno en la configuración de tu aplicación. Este método es útil si no puedes acceder a la interfaz de usuario de Datadog.

1. Confirma que tu kit de desarrollo de software (SDK) cumple los requisitos mínimos de la versión.
2. Establece la siguiente variable de entorno:

   DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED=true
   

Esto garantiza que el atributo service utilice siempre el nombre del servicio base en lugar de añadir el nombre de la integración (por ejemplo, *-postgres, *-http-client). Las sustituciones de servicios personalizadas no se ven afectadas y deben eliminarse directamente en el código.

Referencias adicionales

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

Sobreescritura de serviciosDOCUMENTACIÓN Servicios inferidosDOCUMENTACIÓN