Skip to main content
Version: Next

mellea.telemetry

OpenTelemetry instrumentation for Mellea.

This package provides observability capabilities for Mellea through OpenTelemetry, enabling tracing, metrics, and logging for both application-level operations and backend LLM interactions.

Package Structure:

  • tracing: Distributed tracing with two independent scopes:
    • Application traces (mellea.application): User-facing operations
    • Backend traces (mellea.backend): LLM backend interactions
  • metrics: Metrics collection for counters, histograms, and up-down counters
  • logging: Log export via OTLP

Configuration: All telemetry features are opt-in via environment variables:

Tracing:

  • MELLEA_TRACES_ENABLED: Enable tracing (default: false)
  • MELLEA_TRACES_OTLP: Enable OTLP span exporter (default: false)
  • MELLEA_TRACES_CONSOLE: Print spans to console (default: false)
  • MELLEA_TRACES_CONTENT: Capture prompt/response content on spans (default: false)
  • OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: Trace-specific OTLP endpoint (optional)
  • OTEL_EXPORTER_OTLP_ENDPOINT: General OTLP endpoint (fallback)
  • OTEL_SERVICE_NAME: Service name for traces (default: mellea)

Metrics:

  • MELLEA_METRICS_ENABLED: Enable metrics collection (default: false)
  • MELLEA_METRICS_CONSOLE: Print metrics to console (default: false)
  • MELLEA_METRICS_OTLP: Enable OTLP metrics exporter (default: false)
  • MELLEA_METRICS_PROMETHEUS: Enable Prometheus metric reader (default: false)
  • OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint for metric export (optional)
  • OTEL_EXPORTER_OTLP_METRICS_ENDPOINT: Metrics-specific OTLP endpoint (optional)
  • OTEL_METRIC_EXPORT_INTERVAL: Export interval in milliseconds (default: 60000)
  • OTEL_SERVICE_NAME: Service name for metrics (default: mellea)
  • MELLEA_PRICING_FILE: Path to a JSON file with custom model pricing overrides (optional)

Logging:

  • MELLEA_LOGS_OTLP: Enable OTLP log export (default: false)
  • OTEL_EXPORTER_OTLP_LOGS_ENDPOINT: Logs-specific endpoint (optional)
  • OTEL_EXPORTER_OTLP_ENDPOINT: General OTLP endpoint (fallback)
  • OTEL_SERVICE_NAME: Service name for logs (default: mellea)

Dependencies: OpenTelemetry packages are optional. If not installed, telemetry features are gracefully disabled. Install with: pip install mellea[telemetry]