Rastreo de aplicaciones Python
Requisitos de compatibilidad
Para ver la lista completa de compatibilidad de versiones Python y de marcos de Datadog (incluidas las versiones heredadas y de mantenimiento), consulta la página de requisitos de compatibilidad.
Para empezar
Antes de empezar, asegúrate de haber instalado y configurado el Agent.
Instrumentación de tu aplicación
Después de instalar y configurar tu Datadog Agent, el siguiente paso es añadir la biblioteca de rastreo directamente en la aplicación para instrumentarla. Consulta más bibliografía con información sobre la compatibilidad.
Para empezar a rastrear aplicaciones escritas en Python, instala la biblioteca de rastreo de Datadog, ddtrace, utilizando pip:
Nota: Este comando requiere la versión de pip 18.0.0 o superior. Para Ubuntu, Debian, u otro gestor de paquetes, actualiza tu versión de pip con el siguiente comando:
pip install --upgrade pip
A continuación, para instrumentar tu aplicación Python utiliza el comando incluido ddtrace-run. Para utilizarlo, coloca ddtrace-run delante del comando de punto de entrada de Python.
Por ejemplo, si tu aplicación se inicia con python app.py entonces:
ddtrace-run python app.py
Una vez que hayas terminado la configuración y estés ejecutando el rastreador con tu aplicación, puedes ejecutar ddtrace-run --info para comprobar que las configuraciones funcionan como se espera. Ten en cuenta que el resultado de este comando no refleja los cambios de configuración realizados durante el tiempo de ejecución en el código.
Configuración
Si es necesario, configura la biblioteca de rastreo para que envíe datos de telemetría sobre el rendimiento de la aplicación, incluida la configuración del etiquetado unificado de servicios. Para ver más detalles, consulta la configuración de bibliotecas.
La conexión para trazas también puede configurarse en código:
from ddtrace import tracer
# Sockets de red
tracer.configure(
https=False,
hostname="custom-hostname",
port="1234",
)
# Configuración del socket de dominio Unix
tracer.configure(
uds_path="/var/run/datadog/apm.socket",
)
La conexión para estadísticas también puede configurarse en código:
from ddtrace import tracer
# Socket de red
tracer.configure(
dogstatsd_url="udp://localhost:8125",
)
# Configuración del socket de dominio Unix
tracer.configure(
dogstatsd_url="unix:///var/run/datadog/dsd.socket",
)
Actualización a v1
Si estás actualizando a ddtrace v1, revisa la guía de actualización y las notas de la versión en la documentación de biblioteca para ver todos los detalles.
Leer más
Más enlaces, artículos y documentación útiles:
