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