---
id: opentelemetry-python-contrib-external-valkey
version: "0.64b0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# opentelemetry-python-contrib-external-valkey — OpenTelemetry Valkey instrumentation

License: permissive · Maintenance: active · Downloads: 186.1K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 186.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

opentelemetry valkey instrumentation, valkey tracing observability, valkey client monitoring, distributed tracing valkey, valkey performance metrics, valkey instrumentation library, opentelemetry redis fork, observability, distributed-tracing, valkey-instrumentation

[View on SkillFed](https://skillfed.io/packages/opentelemetry-python-contrib-external-valkey) · [View on PyPI](https://pypi.org/project/opentelemetry-python-contrib-external-valkey/)