opentelemetry-python-contrib-external-valkey

What it is and what it does

This package provides OpenTelemetry instrumentation for the Valkey Python client, a fork of the Redis Python client. It automatically captures Valkey operations and emits tracing data for observability, filling a gap until Valkey receives official support in the main opentelemetry-python-contrib project. The instrumentation works by wrapping Valkey client methods to generate spans and metrics compatible with OpenTelemetry standards.

The package is built as a fork of the Redis instrumentation with minimal changes—primarily string replacements from Redis to Valkey—ensuring feature parity with the established Redis instrumentation. It requires opentelemetry-api, opentelemetry-instrumentation, opentelemetry-semantic-conventions, and wrapt, and targets Python 3.10 or later.

Use it for:

• Monitor Valkey operations in distributed systems to trace request flow and identify latency bottlenecks.
• Export Valkey metrics to observability backends (Jaeger, Datadog, etc.) for centralized monitoring.
• Debug application performance by correlating Valkey calls with other service spans in a trace.
• Audit Valkey client behavior in production without modifying application code.
• Validate Valkey performance during load testing by collecting operation-level metrics.

Worth the install?

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

Adds OpenTelemetry tracing to the Valkey Python client, capturing operations and performance metrics for observability.

Yes, if you use Valkey and need OpenTelemetry tracing. The package has low install friction, active maintenance, no known vulnerabilities, and permissive licensing. However, note that it is a community-maintained external package pending official Valkey support in opentelemetry-python-contrib; verify compatibility with your Valkey version and observability stack before production deployment.

Install

opentelemetry-python-contrib-external-valkey on PyPI

pip install opentelemetry-python-contrib-external-valkey

uv add opentelemetry-python-contrib-external-valkey

poetry add opentelemetry-python-contrib-external-valkey

Installing opentelemetry-python-contrib-external-valkey

Before you install

Low install friction with a pure-Python wheel and only four runtime dependencies (opentelemetry-api, opentelemetry-instrumentation, opentelemetry-semantic-conventions, wrapt). Maintenance status is active with a recent release.

License in practice

Licensed under Apache-2.0 (permissive), allowing use in most commercial and open-source projects without significant restriction.

Quickstart

pip install opentelemetry-python-contrib-external-valkey

from opentelemetry.instrumentation.valkey import ValkeyInstrumentor

ValkeyInstrumentor().instrument()

Requires Python 3.10 or later.

Verify before relying

• Whether this package will be superseded by official Valkey support in opentelemetry-python-contrib.
• Performance overhead of instrumentation on typical Valkey workloads.
• Compatibility with specific Valkey client versions beyond the fork basis.

Package facts

Evidence: opentelemetry_python_contrib_external_valkey-0.64b0-py3-none-any.whl

Tags

More Monitoring packages