redis/redis-py · error · ImportError

OpenTelemetry API is not installed. Install it with: pip ins

Error message

OpenTelemetry API is not installed. Install it with: pip install opentelemetry-api

What it means

Error "OpenTelemetry API is not installed. Install it with: pip install opentelemetry-api" thrown in redis/redis-py.

Source

Thrown at redis/observability/metrics.py:84

class RedisMetricsCollector:
    """
    Collects and records OpenTelemetry metrics for Redis operations.

    This class manages all metric instruments and provides methods to record
    various Redis operations including connection pool events, command execution,
    and cluster-specific operations.

    Args:
        meter: OpenTelemetry Meter instance
        config: OTel configuration object
    """

    METER_NAME = "redis-py"
    METER_VERSION = "1.0.0"

    def __init__(self, meter: Meter, config: OTelConfig):
        if not OTEL_AVAILABLE:
            raise ImportError(
                "OpenTelemetry API is not installed. "
                "Install it with: pip install opentelemetry-api"
            )

        self.meter = meter
        self.config = config
        self.attr_builder = AttributeBuilder()

        # Initialize enabled metric instruments

        if MetricGroup.RESILIENCY in self.config.metric_groups:
            self._init_resiliency_metrics()

        if MetricGroup.COMMAND in self.config.metric_groups:
            self._init_command_metrics()

        if MetricGroup.CONNECTION_BASIC in self.config.metric_groups:
            self._init_connection_basic_metrics()

View on GitHub (pinned to da03cdc7e8)

When it happens

Trigger: Thrown at redis/observability/metrics.py:84 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of redis/redis-py@da03cdc7e8 (2026-08-04). Data as JSON: /data/errors/312d7b06c6fc274c.json. Report an issue: GitHub.