Configuración de la biblioteca de rastreo de Python
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 unificado de servicios.
Cuando se utiliza ddtrace-run, se pueden utilizar las siguientes opciones de variables de entorno:
DD_TRACE_DEBUG
- Por defecto:
false
Habilita el registro de depuración en el rastreador. DD_PATCH_MODULES
- Anula los módulos que tienen parches para la ejecución de esta aplicación. Sigue el formato:
DD_PATCH_MODULES=module:patch,module:patch...
.
Se recomienda utilizar DD_ENV
, DD_SERVICE
y DD_VERSION
para configurar env
, service
y version
para tus servicios. Para obtener recomendaciones sobre la configuración de estas variables de entorno, consulta la documentación sobre etiquetado unificado de servicios.
DD_ENV
- Define el entorno de la aplicación , por ejemplo:
prod
, pre-prod
, staging
. Obtén más información sobre cómo configurar tu entorno. Disponible en la versión 0.38 o posterior. DD_SERVICE
- El nombre de servicio que se utilizará para esta aplicación. El valor se pasa cuando se configura el middleware para integraciones de marcos web como Pylons, Flask o Django. Para rastrear sin una integración web, se recomienda definir el nombre del servicio en código (por ejemplo, consulta estos documentos de Django). Disponible en la versión 0.38 o superior.
DD_TRACE_PROPAGATION_STYLE_INJECT
- Por defecto:
tracecontext,Datadog
Estilos de propagación a utilizar al inyectar cabeceras de rastreo. Por ejemplo, utiliza DD_TRACE_PROPAGATION_STYLE_INJECT=Datadog,B3
para inyectar cabeceras con los formatos de Datadog y B3. DD_TRACE_PROPAGATION_STYLE_EXTRACT
- Por defecto: Valor de
DD_TRACE_PROPAGATION_STYLE_INJECT
(tracecontext,Datadog
)
Estilos de propagación a utilizar cuando se extraen cabeceras de rastreo. Cuando se dan múltiples valores, se utiliza la primera coincidencia de cabecera encontrada. El orden de coincidencia se basa en el orden de los valores dados. Por ejemplo, DD_TRACE_PROPAGATION_STYLE_EXTRACT=B3,Datadog
busca primero las cabeceras de B3
y sólo utiliza las de Datadog
, si las primeras no están disponibles. DD_SERVICE_MAPPING
- Define asignaciones de nombres de servicios para permitir renombrar servicios en trazas, por ejemplo:
postgres:postgresql,defaultdb:postgresql
. Disponible en la versión 0.47 o posterior. DD_VERSION
- Define la versión de la aplicación, por ejemplo:
1.2.3
, 6c44da20
, 2020.02.13
. Disponible en la versión 0.38 o posterior. DD_TRACE_SAMPLE_RATE
- Activa el control del volumen del rastreo.
DD_TRACE_SAMPLING_RULES
- Por defecto:
[]
Una matriz JSON de objetos. Cada objeto debe tener una "sample_rate"
. Los campos "name"
y "service"
son opcionales. El valor de "sample_rate"
debe estar comprendido entre 0.0
y 1.0
(inclusive). Las reglas se aplican en el orden configurado para determinar la frecuencia de muestreo de la traza. DD_TRACE_RATE_LIMIT
- Número máximo de tramos a muestrear por segundo, por cada proceso Python. Por defecto es
100
cuando DD_TRACE_SAMPLE_RATE
está configurada. De lo contrario, delega la limitación de frecuencias al Datadog Agent. DD_SPAN_SAMPLING_RULES
- Por defecto:
[]
Una matriz JSON de objetos. Las reglas se aplican en el orden configurado para determinar la frecuencia de muestreo de tramos. El valor de sample_rate
debe estar comprendido entre 0,0 y 1,0 (inclusive).
Para obtener más información, consulta Mecanismos de consumo.
Ejemplo:
- Define la frecuencia de muestreo de tramos en 50% para el nombre de servicio
my-service
y de operación http.request
, hasta 50 trazas por segundo: '[{"service": "my-service", "name": "http.request", "sample_rate":0.5, "max_per_second": 50}]'
DD_TAGS
- Una lista de etiquetas por defecto que se añadirá a cada tramo y perfil, por ejemplo:
layer:api,team:intake,key:value
. Disponible en la versión 0.38 o posterior. DD_TRACE_HEADER_TAGS
- Por defecto:
null
Lista separada por comas de nombres de cabecera que se informan en el tramo raíz como etiquetas. Por ejemplo, DD_TRACE_HEADER_TAGS="User-Agent:http.user_agent,Referer:http.referer,Content-Type:http.content_type,Etag:http.etag"
. DD_TRACE_ENABLED
- Por defecto:
true
Habilita la instrumentación de marcos web y bibliotecas. Cuando es false
, el código de la aplicación no genera trazas. DD_AGENT_HOST
- **Por defecto:
localhost
Anula la dirección del host del Trace Agent a la que el rastreador por defecto intenta enviar trazas.
DD_AGENT_PORT
Por defecto: 8126
Anula el puerto del Trace Agent al que el el rastreador por defecto envía trazas. Si la configuración del Agent configura receiver_port
o DD_APM_RECEIVER_PORT
con un valor distinto al predeterminado 8126
, DD_TRACE_AGENT_PORT
o DD_TRACE_AGENT_URL
deben coincidir con él.
DD_TRACE_AGENT_URL
- La URL del Trace Agent a la que envía el rastreador. Si se define, tiene prioridad sobre el nombre del host y puerto. Admite sockets de dominio Unix (UDS), en combinación con la configuración
apm_config.receiver_socket
en tu archivo datadog.yaml
, o la variable de entorno DD_APM_RECEIVER_SOCKET
definida en el Datadog Agent . Por ejemplo, DD_TRACE_AGENT_URL=http://localhost:8126
para URL HTTP y DD_TRACE_AGENT_URL=unix:///var/run/datadog/apm.socket
para UDS. Si la configuración del Agent configura receiver_port
o DD_APM_RECEIVER_PORT
con un valor distinto al predeterminado 8126
, DD_AGENT_PORT
o DD_TRACE_AGENT_URL
deben coincidir con él. DD_DOGSTATSD_URL
- La URL utilizada para conectarse al Datadog Agent para métricas de DogStatsD. Si se define, tiene prioridad sobre el nombre del host y puerto. Admite sockets de dominio Unix (UDS), en combinación con la configuración
dogstatsd_socket
en tu archivo datadog.yaml
, o la variable de entorno DD_DOGSTATSD_SOCKET
definida en el Datadog Agent . Por ejemplo, DD_DOGSTATSD_URL=udp://localhost:8126
para URL UDP y DD_DOGSTATSD_URL=unix:///var/run/datadog/dsd.socket
para UDS. Si la configuración del Agent configura dogstatsd_port
o DD_DOGSTATSD_PORT
con un valor distinto al predeterminado 8125
, la biblioteca de rastreo DD_DOGSTATSD_URL
o DD_DOGSTATSD_PORT
debe coincidir con él. DD_DOGSTATSD_HOST
- Por defecto:
localhost
Anula la dirección del host del Trace Agent a la que el rastreador por defecto intenta enviar métricas de DogStatsD. Utiliza DD_AGENT_HOST
para anular DD_DOGSTATSD_HOST
. **Por defecto: 8125
Anula el puerto por defecto del Trace Agent para el envío de métricas de DogStatsD. Si la configuración del Agent configura dogstatsd_port
o DD_DOGSTATSD_PORT
con un valor distinto al predeterminado 8125
, DD_DOGSTATSD_PORT
o DD_DOGSTATSD_PORT
de la biblioteca de rastreo deben coincidir con él.
DD_LOGS_INJECTION
- Por defecto:
false
Habilita la conexión de la inyección de logs y trazas.
Leer más
Additional helpful documentation, links, and articles: