Configuración de la biblioteca de rastreo de C++
Después de configurar la biblioteca de rastreo con tu código y de configurar el Agent para recopilar datos de APM, también puedes configurar la biblioteca de rastreo como prefieras e incluir la configuración del etiquetado de servicios unificado.
Es recomendado utilizar DD_SERVICE, DD_ENV y DD_VERSION para establecer env, service y version para tus servicios. Consulta las recomendaciones de la documentación etiquetado de servicios unificado sobre qué valor establecer para las variables de entorno.
Variables de entorno
Para configurar el rastreador mediante variables de entorno, establece las variables antes de lanzar la aplicación instrumentada.
DD_SERVICE- Desde: v0.1.0
Establece el nombre de servicio. DD_ENV- Desde: v0.1.0
Ejemplo: prod, pre-prod, o staging
Añade la etiqueta env con el valor especificado a todos los tramos generados. DD_VERSION- Desde: v0.1.0
Ejemplo: 1.2.3, 6c44da20, 2020.02.13
Establece la versión del servicio. DD_TAGS- Desde: v0.1.0
Ejemplo: team:intake,layer:api,foo:bar
Una lista separada por comas de pares key:value que se añadirán a todos los tramos generados. DD_AGENT_HOST- Desde: v0.1.0
Por defecto: localhost
Establece el host donde se envían las trazas (el host que ejecuta el Agent). Puede ser un nombre de host o una dirección IP. Se ignora si DD_TRACE_AGENT_URL está configurado. DD_TRACE_AGENT_PORT- Desde: v0.1.0
Por defecto: 8126
Establece el puerto al que se envían trazas (el puerto en el que el Agent escucha conexiones). Se ignora si DD_TRACE_AGENT_URL está configurado. Si la configuración del Agent establece receiver_port o DD_APM_RECEIVER_PORT en algo distinto del valor predeterminado 8126, entonces DD_TRACE_AGENT_PORT o DD_TRACE_AGENT_URL deben coincidir con él. DD_TRACE_AGENT_URL- Desde: v0.1.0
Por defecto: http://<DD_AGENT_HOST>:<DD_TRACE_AGENT_PORT> si están configurado, o http://localhost:8126.
Ejemplos:
URL HTTP: http://localhost:8126
Unix Domain Socket: unix:///var/run/datadog/apm.socket
Establece el endpoint de la URL donde se envían trazas. Sustituye DD_AGENT_HOST y DD_TRACE_AGENT_PORT si están definidos. Esta URL admite esquemas de direcciones HTTP, HTTPS y Unix.
Si la configuración del Agent establece receiver_port o DD_APM_RECEIVER_PORT en algo distinto del valor predeterminado 8126, entonces DD_TRACE_AGENT_PORT o DD_TRACE_AGENT_URL deben coincidir con él. DD_TRACE_RATE_LIMIT- Desde: 0.1.0
Por defecto: 200
Número máximo de trazas que se permite enviar por segundo. DD_TRACE_SAMPLE_RATE- Desde: 0.1.0
Por defecto: La frecuencia por defecto de Datadog Agent o 1.0.
Establece la frecuencia de muestreo para todas las trazas generadas. El valor debe estar comprendido entre 0.0 y 1.0 (ambos inclusive). Por defecto, la frecuencia de muestreo se delega al Datadog Agent. Si el Datadog Agent no establece ninguna frecuencia de muestreo, el valor predeterminado es 1.0. DD_TRACE_SAMPLING_RULES- Desde: v0.1.0
Por defecto: null
Ejemplos:
Establece la frecuencia de muestreo en 20%: [{"sample_rate": 0.2}]
Establece la frecuencia de muestreo del tramo al 50% para el servicio my-service y el nombre de la operación http.request, hasta 50 trazas por segundo: '[{"service": "my-service", "name": "http.request", "sample_rate":0.5, "max_per_second": 50}]'
Una matriz de objetos JSON. Cada objeto debe tener una sample_rate, y los campos name y service son opcionales. El valor de sample_rate debe estar comprendido entre 0,0 y 1,0 (ambos inclusive). Las reglas se aplican en el orden configurado para determinar la frecuencia de muestreo de la traza.
Para más información, consulta Mecanismos de ingesta.
DD_SPAN_SAMPLING_RULES- Versión: v0.1.0
**Por defecto null
Una matriz de objetos JSON. Las reglas se aplican en el orden configurado para determinar la frecuencia de muestreo del tramo. El valor de sample_rate debe estar comprendido entre 0.0 y 1.0 (ambos inclusive). DD_SPAN_SAMPLING_RULES_FILE- Desde: 0.1.0
Apunta a un archivo JSON que contiene las reglas de muestreo del tramo. Consulta DD_SPAN_SAMPLING_RULES para conocer el formato de las reglas. DD_PROPAGATION_STYLE- Desde: 0.1.0
Lista separada por comas de los estilos de propagación a utilizar al extraer e inyectar el contexto de rastreo.
Cuando se dan múltiples valores, el orden de coincidencia se basa en el orden de los valores. DD_TRACE_PROPAGATION_STYLE_INJECT- Desde: v0.1.6
Por defecto: datadog,tracecontext
Valores aceptados: datadog, tracecontext, b3
Lista separada por comas de estilos de propagación a utilizar cuando se inyecta contexto de rastreo.
Cuando se establecen múltiples valores, el orden de coincidencia se basa en el orden de los valores. DD_TRACE_PROPAGATION_STYLE_EXTRACT- Desde: v0.1.6
Por defecto: datadog,tracecontext
Valores aceptados: datadog, tracecontext, b3
Lista separada por comas de los estilos de propagación a utilizar al extraer el contexto de rastreo.
Cuando se establecen múltiples valores, el orden de coincidencia se basa en el orden de los valores. DD_TRACE_ENABLED- Desde: 0.1.0
Por defecto: true
Enviar o no trazas al Datadog Agent .
Cuando es false, la biblioteca deja de enviar trazas al Datadog Agent. Sin embargo, la biblioteca continúa generando trazas, informando la telemetría y sondeando actualizaciones de configuración remotas. DD_TRACE_REPORT_hostNAME- Desde: 0.1.0
Por defecto: false
Añade la etiqueta hostname con el resultado de gethostname. DD_TRACE_STARTUP_LOGS- Desde: 0.1.0
Por defecto: true
Loguear la configuración del rastreador una vez que el rastreador está completamente inicializado.
DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED- Desde: 0.1.6
Por defecto: true
Si es true, el rastreador generará IDs de traza de 128 bits.
Si es false, el rastreador generará IDs de traza legacy de 64 bits. DD_INSTRUMENTATION_TELEMETRY_ENABLED- Desde: 0.1.12
Por defecto: true
Datadog puede recopilar información de entorno y de diagnóstico sobre tu sistema para mejorar el producto. Cuando es false, no se recopilan datos de telemetría. DD_REMOTE_CONFIGURATION_ENABLED- Desde: 0.2.0
Por defecto: true
Habilita la capacidad que permite configurar de forma remota y cambiar el comportamiento del rastreador.
Si es false, esta función está deshabilitada.
Para más información, consulta Configuración remota. DD_REMOTE_CONFIG_POLL_INTERVAL_SECONDS- Desde: 0.2.0
Por defecto: 5.0
Establece la frecuencia, en segundos, con la que se consulta al Datadog Agent en busca de actualizaciones de configuración remota. DD_TRACE_DELEGATE_SAMPLING- Versión: 0.2.0
Por defecto: false
Si es true, delega la decisión de muestreo de trazas a un servicio secundario y prefiere la decisión resultante a la suya propia, si procede.
Lectura adicional
Más enlaces, artículos y documentación útiles:
