Instrumentación de APM de step (UI) / paso único en Docker

Documentos > APM > Instrumentación de aplicación > Single Step APM Instrumentation > Instrumentación de APM de step (UI) / paso único en Docker

Información general

En un contenedor Docker Linux, utiliza la instrumentación de un solo paso (SSI) para que APM instale el Datadog Agent e instrumente tus aplicaciones en un solo paso, sin necesidad de configuración adicional.

Activar APM en tus aplicaciones

Antes de continuar, confirma que tu entorno es compatible consultando la guía de compatibilidad de SSI.

Para activar APM en un contenedor Docker Linux:

En Datadog, ve a la página Instalar el Datadog Agent en Docker.
En la sección Customize my Agent install command (Personalizar mi comando de instalación del Agent), ve a Additional configuration > Application Observability (Configuración adicional > Observabilidad de aplicaciones), y activa APM Instrumentation (Instrumentación APM).
Copia y ejecuta el comando de instalación del Agent en tu contenedor Docker. Si el Agent ya se está ejecutando, vuelve a desplegar el contenedor del Agent utilizando el nuevo comando.
Reinicia tus aplicaciones.

SSI añade una pequeña cantidad de tiempo de inicio a las aplicaciones instrumentadas. Si esta sobrecarga no es aceptable para tu uso caso de uso, ponte en contacto con el servicio de asistencia de Datadog.

Configurar versiones de rastreador del SDK

Por defecto, la instrumentación de un solo paso instala las últimas versiones principales de los SDK de Datadog APM. Las actualizaciones de versiones menores se aplican automáticamente cuando están disponibles.

Es posible que quieras personalizar las versiones de SDK en función de la versión de lenguaje de tu aplicación o de los requisitos específicos del entorno. Puedes controlar las versiones principales y menores utilizadas personalizando las versiones de biblioteca durante la configuración.

Para personalizar las versiones de rastreador:

En Datadog, ve a la página Instalar el Datadog Agent en Docker.
Después de activar APM Instrumentation (Instrumentación APM), haz clic en Customize library versions (Personalizar versiones de biblioteca).
Busca tu(s) lenguaje(s) y utiliza el menú desplegable para:
- Fijar una versión exacta de rastreador, o
- Seleccionar la versión principal que quieres utilizar.
Copiar y ejecutar el comando de instalación actualizado.

Las versiones disponibles figuran en los repositorios fuentes de cada lenguaje:

Java (java)
Node.js (js)
Python (python)
.NET (dotnet)
Ruby (ruby)
PHP (php)

Configurar etiquetas (tags) de servicio unificadas

Las etiquetas de servicio unificadas (UST) aplican etiquetas coherentes en trazas (traces), métricas y logs, lo que facilita la navegación y la correlación de los datos de observabilidad. Más información sobre cómo configurar UST para servicios Docker.

Activar productos y funciones dependientes de SDK

Una vez que SSI cargue el SDK de Datadog en tus aplicaciones y habilite el rastreo distribuido, puedes configurar productos adicionales que dependan del SDK. Estos incluyen funcionalidades como Continuous Profiler, App and API Protection y controles de ingesta de trazas.

Para activar los productos, define variables de entorno en la configuración de tu aplicación.

Eliminar la instrumentación APM de un solo paso de tu Agent

Si no quieres recopilar datos de trazas de un determinado servicio, host, máquina virtual o contenedor, sigue los pasos que se indican a continuación:

Eliminación de la instrumentación en servicios específicos

Para eliminar la instrumentación de APM y dejar de enviar trazas desde un servicio específico:

Añade la variable de entorno DD_INSTRUMENT_SERVICE_WITH_APM al comando de inicio de servicio:
```
docker run -e DD_INSTRUMENT_SERVICE_WITH_APM=false <service_start_command>
```
Reinicia el servicio.