Skip to main content

Observability (logging, metrics, tracing)

Tracing: When OpenTelemetry is configured globally, the SDK adds spans per HTTP request.

  • Auto-detection via is_tracing_configured() checks tracer provider and common OTEL env vars.
  • Attributes: http.method, url.full, server.address, http.status_code, component=nexla-sdk.
  • Trace context propagation via W3C trace headers when OTEL is available.

Enable (example):

export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
export OTEL_SERVICE_NAME=nexla-sdk-example

Traceability:

  • nexla_sdk/telemetry.py:1
  • nexla_sdk/http_client.py:37