Python

ClickStack usa el estándar OpenTelemetry para recopilar datos de telemetría (logs y trazas). Las trazas se generan automáticamente con instrumentación automática, por lo que no se requiere instrumentación manual para empezar a aprovechar el tracing.

Esta guía integra:

• Logs
• Métricas
• Trazas

Usa el siguiente comando para instalar el paquete de OpenTelemetry de ClickStack.

pip install hyperdx-opentelemetry

Instala las bibliotecas de instrumentación automática de OpenTelemetry para los paquetes que utiliza tu aplicación en Python. Recomendamos que uses la herramienta opentelemetry-bootstrap, incluida en el SDK de OpenTelemetry para Python, para analizar los paquetes de tu aplicación y generar la lista de bibliotecas disponibles.

opentelemetry-bootstrap -a install

A continuación, tendrás que configurar las siguientes variables de entorno en tu shell para enviar telemetría a ClickStack a través del collector de OpenTelemetry:

OTEL_SERVICE_NAME='<NAME_OF_YOUR_APP_OR_SERVICE>' \
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 

export HYPERDX_API_KEY='<YOUR_INGESTION_API_KEY>' \
OTEL_SERVICE_NAME='<NAME_OF_YOUR_APP_OR_SERVICE>' \
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 

La variable de entorno OTEL_SERVICE_NAME se utiliza para identificar tu servicio en la aplicación HyperDX; puede ser cualquier nombre que quieras.

Ahora puedes ejecutar la aplicación con el agente de Python de OpenTelemetry (opentelemetry-instrument).

opentelemetry-instrument python app.py

En este caso, el agente de Python de OpenTelemetry requerirá cambios adicionales para funcionar.

Para configurar OpenTelemetry en servidores de aplicaciones que usan el modo de servidor web pre-fork, asegúrate de llamar al método configure_opentelemetry dentro del hook posterior al fork.

from hyperdx.opentelemetry import configure_opentelemetry

def post_fork(server, worker):
    configure_opentelemetry()

from hyperdx.opentelemetry import configure_opentelemetry
from uwsgidecorators import postfork

@postfork
def init_tracing():
    configure_opentelemetry()

Al habilitar las funciones de captura de red, los desarrolladores pueden depurar eficazmente los encabezados de las solicitudes HTTP y las cargas útiles del cuerpo. Esto puede lograrse simplemente estableciendo la bandera HYPERDX_ENABLE_ADVANCED_NETWORK_CAPTURE en 1.

export HYPERDX_ENABLE_ADVANCED_NETWORK_CAPTURE=1

De forma predeterminada, el handler de logging de OpenTelemetry usa el nivel logging.NOTSET, que por defecto equivale al nivel WARNING. Puede especificar el nivel de logging al crear un logger:

import logging

logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

El SDK de Python de OpenTelemetry suele mostrar errores en la consola cuando se producen. Sin embargo, si no aparece ningún error, pero observas que tus datos no se muestran en HyperDX como deberían, puedes habilitar el modo de depuración. Cuando el modo de depuración está activado, todos los datos de telemetría se imprimirán en la consola, lo que te permitirá comprobar si tu aplicación está correctamente instrumentada con los datos esperados.

export DEBUG=true

Obtén más información sobre la instrumentación de OpenTelemetry para Python aquí: https://opentelemetry.io/docs/instrumentation/python/manual/