Instrumentación de aplicaciones

Documentos > APM > Instrumentación de aplicaciones

Descripción general

Aplicación instrumentación con Datadog APM implica:

Configuración del SDK: Agregar un SDK de Datadog a tu aplicación.
Creación de tramos: Capturando datos de observabilidad como tramos.
Los tramos se generan automáticamente por defecto tan pronto como se carga el SDK. Esto se conoce como auto-instrumentación y proporciona visibilidad suficiente para la mayoría de los usuarios. Si necesitas más control, puedes agregar tramos personalizados opcionalmente.

Nota: Estos pasos asumen que tienes un Agente de Datadog instalado y configurado para recibir trazas.

Comenzando

¿Prefieres instrumentación neutral ante proveedores? Consulta la documentación de OpenTelemetry para usar OpenTelemetry con Datadog.

Instrumentación de un Solo Paso (recomendada)

La Instrumentación de un Solo Paso (SSI) instala y configura automáticamente los SDK de Datadog con un solo comando. La auto-instrumentación comienza inmediatamente a capturar trazas de tus marcos y bibliotecas soportados, sin necesidad de cambios en el código.

Comienza con Instrumentación de un Solo Paso

Configuración manual y tramos personalizados

A medida que tus necesidades de observabilidad crecen, puedes agregar más control y personalización:

Para un control completo de la configuración del SDK: Usa SDKs de Datadog gestionados manualmente si necesitas un control granular sobre el comportamiento y la configuración del SDK.

Usa SDKs de Datadog gestionados manualmente

Para spans personalizados sin cambios en el código: Usa Instrumentación Dinámica para crear spans personalizados desde la interfaz de usuario de Datadog sin redeplegar tu aplicación.

Agrega tramos personalizados con Instrumentación Dinámica

Para tramos personalizados en el código: Agrega instrumentación personalizada basada en código para instrumentar la lógica de negocio personalizada o agregar metadatos específicos de la aplicación a los tramos.

Agrega tramos personalizados con instrumentación basada en código

Estas opciones pueden combinarse. Por ejemplo, puedes comenzar con Instrumentación de un Solo Paso y agregar instrumentación personalizada basada en código para tramos específicos, o usar SDKs gestionados manualmente con Instrumentación Dinámica para adiciones de tramos sin despliegue.

Comparación detallada

Configuración del SDK

La Instrumentación de un Solo Paso es el punto de partida recomendado para la mayoría de los usuarios. Si necesitas más control sobre la configuración del SDK, puedes usar SDKs gestionados manualmente en su lugar:

	Instrumentación de un Solo Paso (recomendada)	SDKs gestionados manualmente
Cómo funciona	Datadog instala y carga automáticamente los SDKs en los procesos de tu aplicación, en tiempo de ejecución, con un solo comando.	Instala y configura los SDKs directamente en el código de tu aplicación o en el proceso de construcción.
¿Cambios en el código?	No	Sí
Complejidad de configuración	Bajo - configuración mínima necesaria	Medio - requiere configuración del entorno y de la construcción
Control de configuración	Valores predeterminados estándar con sobreescrituras opcionales	Control total a través de variables de entorno y código
Cuándo usar	Comience aquí para una instrumentación rápida y consistente a través de servicios sin cambios en el código.	Avanza a esto cuando necesites un control granular sobre el comportamiento y la configuración del SDK.

Personalización de tramos

La auto-instrumentación crea automáticamente tramos para frameworks y bibliotecas compatibles, proporcionando una observabilidad esencial sin trabajo adicional. Cuando necesites visibilidad en rutas de código personalizadas o desees enriquecer trazas con datos específicos de la aplicación, puedes agregar tramos personalizados utilizando ya sea Instrumentación Dinámica o instrumentación personalizada basada en código:

	Instrumentación Dinámica	Instrumentación personalizada basada en código
Cómo funciona	Configura las reglas de instrumentación en la interfaz de usuario de Datadog; las reglas se aplican en tiempo de ejecución.	Agrega llamadas a la API de traza explícitas en el código de tu aplicación.
¿Cambios en el código?	No	Sí
Despliegue requerido	No	Sí (para agregar o modificar tramos)
Cuándo usar	Agrega tramos personalizados sin cambios en el código ni reimplementaciones.	Avanza a esto cuando necesites una lógica de instrumentación compleja o desees que los tramos estén definidos permanentemente en el código.

Tutoriales de configuración de APM

Los siguientes tutoriales te guían a través de la configuración de trazado distribuido para una aplicación de muestra en varios escenarios de infraestructura, con instrumentación automática y personalizada:

Elige tu lenguaje y entorno: