Configuración en tiempo de ejecución

Documentos > APM > Instrumentación de aplicación > Configuración en tiempo de ejecución

Esta función está en fase beta pública.

Información general

La configuración en tiempo de ejecución te permite modificar la configuración de la biblioteca APM desde la interfaz de usuario Datadog, sin necesidad de reiniciar tu aplicación o servicio. No necesitas esperar a un nuevo despliegue o a un cambio de código para actualizar tu configuración. En su lugar, actualízala inmediatamente mediante la configuración en tiempo de ejecución.

Requisitos previos

Datadog Agent 7.41.1 o superior.
Configuración remota activada para tu Agent.
Permisos APM Remote Configuration Read y APM Remote Configuration Write. Nota: Si no tienes estos permisos, pide a tu administrador de Datadog que actualice tus permisos desde los parámetros de la organización.

Utilización de la configuración en tiempo de ejecución

Para realizar cambios en la configuración de un servicio en tiempo de ejecución:

Ve al Catálogo de servicios en APM.
Sitúate sobre el servicio del que quieres actualizar la configuración.
Haz clic en Full Page (Página completa), junto al nombre del servicio.
Haz clic en Service Info (Información del servicio).
En la pestaña Setup Guidance (Guía para la configuración), haz clic en Edit (Editar).
Cambia las opciones de configuración, según sea necesario. Para obtener más detalles, consulta las opciones de configuración compatibles.
Haz clic en Apply Configuration (Aplicar configuración).

En Active Library Configuration (Configuración de biblioteca activa), puedes ver qué opciones están configuradas para este servicio y el entorno seleccionado:

Desde la pestaña Guía para la configuración, puedes ver la configuración de tu biblioteca activa.

En este ejemplo, puedes ver que la inyección de logs está habilitada para el entorno de staging a través en dos instancias. Una instancia se refiere a una instancia del cliente de configuración remota. Debería haber una instancia por cada proceso de tu aplicación.

Puedes saber cuándo se han aplicado correctamente los cambios de configuración consultando el texto X Applied*. En este ejemplo, la configuración se ha aplicado correctamente a las dos instancias.

Opciones de configuración compatibles

Las siguientes opciones son compatibles con la configuración en tiempo de ejecución. Para cada lenguaje, se indica la versión de rastreador necesaria:

Opción	Java	JavaScript	Python	.NET	Ruby	Go	C++
Frecuencia de muestreo personalizada Define una frecuencia de muestreo global para la biblioteca utilizando `DD_TRACE_SAMPLE_RATE`.	`1.17.0+`	`4.11+` `3.32+` `2.45+`	`2.4.0+`	`2.33.0+`	`1.13.0+`	`1.59.0+`	`0.2.0+`
Inyección de logs Inyecta automáticamente identificadores de correlación de rastreo para correlacionar logs y trazas, habilitando `DD_LOGS_INJECTION`.	`1.17.0+`	`4.11+` `3.32+` `2.45+`	`2.6.0+`	`2.33.0+`	`1.13.0+`
Etiquetas de cabeceras HTTPAñada valores de cabeceras HTTP como etiquetas en trazas, utilizando `DD_TRACE_HEADER_TAGS`.	`1.17.0+`	`4.11+` `3.32+` `2.45+`	`2.6.0+`	`2.33.0+`	`1.13.0+`	`1.59.0+`
Etiquetas de tramos personalizadasAñade las etiquetas especificadas a cada tramo, utilizando `DD_TAGS`.	`1.31.0+`	`4.23.0+` `3.44.0+`	`2.5.0+`	`2.44.0+`		`1.59.0+`	`0.2.0+`