Instrumentación de APM en un paso en Docker

Documentos > APM > Instrumentación de aplicación > Instrumentación automática > Single Step Instrumentation para APM > Instrumentación de APM en un paso en Docker

Información general

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

Activa APM en tus aplicaciones

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

Para habilitar 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 de 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 suma una pequeña cantidad de tiempo de arranque a las aplicaciones instrumentadas. Si esta sobrecarga no es aceptable para su caso de uso, ponte en contacto con el servicio de asistencia de Datadog.

Configurar versiones de rastreador del SDK

Por defecto, la instrumentación en un solo paso instala las últimas versiones principales de los SDKs de Datadog APM. Las actualizaciones de versiones secundarias 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 secundarias utilizadas personalizando las versiones de biblioteca durante la configuración.

Para personalizar las versiones del rastreador:

En Datadog, ve a la página Instalar el Datadog Agent en Docker.
Después de activar APM Instrumentation (Instrumentación de APM), haz clic en Customize library versions (Personalizar versiones de biblioteca).
Busca tus lenguajes 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 de servicio unificadas

Las etiquetas de servicio unificadas (USTs) aplican etiquetas coherentes en trazas, 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 USTs para servicios de Docker.

Activar productos y funciones dependientes de SDK

Una vez que la 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 de APM en 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.