opentelemetry-instrumentation-alephalpha

What it is and what it does

This package is an OpenTelemetry instrumentation plugin that automatically intercepts and traces all calls made through the official Aleph Alpha Client library. Once initialized with a single call to `AlephAlphaInstrumentor().instrument()`, it captures request and response data as OpenTelemetry spans, enabling you to observe and debug your LLM application's behavior.

By default, the instrumentation logs prompts, completions, and embeddings to span attributes for full visibility into your application's LLM interactions. This can be disabled by setting the `TRACELOOP_TRACE_CONTENT` environment variable to `false` if you need to protect sensitive user data or reduce trace size. The package integrates with the OpenTelemetry ecosystem, meaning the traces it generates can be exported to any backend that supports OpenTelemetry (Jaeger, Datadog, etc.).

Use it for:

• Debug LLM application behavior by examining prompts, completions, and embeddings in distributed traces.
• Monitor Aleph Alpha API performance and latency across your application without modifying client code.
• Collect observability data for quality evaluation and cost analysis of LLM calls in production.
• Integrate Aleph Alpha tracing into an existing OpenTelemetry observability stack.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Automatically captures and traces calls to Aleph Alpha's LLM endpoints when using the official Aleph Alpha Client, integrating with OpenTelemetry for observability.

Yes, if you are using the Aleph Alpha Client and need observability into LLM calls. The package is actively maintained, has no known vulnerabilities, and integrates seamlessly into OpenTelemetry workflows. Be aware that by default it logs sensitive data (prompts and completions) to traces—set TRACELOOP_TRACE_CONTENT=false if privacy is a concern.

Install

opentelemetry-instrumentation-alephalpha on PyPI

pip install opentelemetry-instrumentation-alephalpha

uv add opentelemetry-instrumentation-alephalpha

poetry add opentelemetry-instrumentation-alephalpha

Installing opentelemetry-instrumentation-alephalpha

Before you install

Low friction install with four runtime dependencies, all from the OpenTelemetry ecosystem. The package is actively maintained with a recent release (4 days old) and no known vulnerabilities.

License in practice

Apache-2.0 is permissive; you can use this package freely in commercial and private projects without restriction, though you must include a copy of the license.

Quickstart

pip install opentelemetry-instrumentation-alephalpha

from opentelemetry.instrumentation.alephalpha import AlephAlphaInstrumentor

AlephAlphaInstrumentor().instrument()

Requires Python 3.10 or later; the Aleph Alpha Client must be installed separately for instrumentation to have effect.

Verify before relying

• Whether this instrumentation works with all versions of the Aleph Alpha Client or only specific versions.
• Performance overhead when tracing is enabled, especially with TRACELOOP_TRACE_CONTENT set to true.
• How to configure which OpenTelemetry exporters receive the trace data.

Package facts

Evidence: opentelemetry_instrumentation_alephalpha-0.62.3-py3-none-any.whl

Tags

More Monitoring packages