Configuración en tiempo de ejecución
Esta función está en fase beta pública.
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:
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 personalizadaDefine 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 logsInyecta 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+ |
Leer más
Additional helpful documentation, links, and articles: