---
id: opentelemetry-instrumentation-grpc
version: "0.65b0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# opentelemetry-instrumentation-grpc — OpenTelemetry gRPC instrumentation

License: permissive · Maintenance: active · Downloads: 18.8M/mo

## What it is and what it does

This package integrates OpenTelemetry tracing into gRPC Python applications by providing client and server interceptors. It automatically captures gRPC call metadata, timing, and errors, feeding that telemetry into your OpenTelemetry pipeline for centralized observability. The package depends on opentelemetry-api, opentelemetry-instrumentation, opentelemetry-semantic-conventions, and wrapt to hook into gRPC calls without requiring code changes to your service logic.

It's designed for developers building microservices or distributed systems where gRPC is the communication layer and you need visibility into call patterns, latencies, and failures. The instrumentation runs as middleware, so once installed and configured with an OpenTelemetry exporter, your gRPC traffic automatically flows into your observability backend (Jaeger, Datadog, etc.).

Use it for:

- Trace gRPC calls across microservices to debug latency and failure paths in distributed systems
- Monitor gRPC server performance and client request patterns in production environments
- Export gRPC call metrics to centralized observability platforms like Jaeger or Prometheus
- Correlate gRPC traces with other application telemetry for end-to-end request visibility
- Identify slow or failing gRPC endpoints by analyzing captured call metadata and timing

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds automatic tracing and monitoring to gRPC Python client and server calls through OpenTelemetry interceptors, capturing request/response metadata and performance metrics.

Yes, if you are already using OpenTelemetry and gRPC Python. The package is actively maintained, has no known vulnerabilities, and low install friction. It's a standard instrumentation module in the OpenTelemetry ecosystem. Install it only if you need gRPC tracing; it adds no value without an OpenTelemetry exporter configured downstream.

## Install

pip install opentelemetry-instrumentation-grpc
uv add opentelemetry-instrumentation-grpc
poetry add opentelemetry-instrumentation-grpc

## Installing opentelemetry-instrumentation-grpc

Before you install: Low friction installation with a pure-Python wheel and four lightweight runtime dependencies. Active maintenance with a recent release (29 days old) and ongoing commits; part of the established OpenTelemetry ecosystem.

License in practice: Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart:

pip install opentelemetry-instrumentation-grpc

from opentelemetry.instrumentation.grpc_instrumentation import GrpcInstrumentationServer

instrumentor = GrpcInstrumentationServer()
instrumentor.instrument()

Requires Python 3.10 or later; gRPC Python must be installed separately (not declared as a direct dependency in this package).

Verify before relying:

- Whether this package requires gRPC to be installed separately or if it's a transitive dependency
- Support for async gRPC patterns and whether both client and server interceptors are equally mature
- Performance overhead of instrumentation in high-throughput scenarios

## Package facts

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

## Tags

grpc tracing instrumentation, opentelemetry grpc monitoring, grpc request tracing, distributed tracing grpc, grpc performance metrics, grpc observability, grpc call interceptors, observability, distributed-tracing, grpc

[View on SkillFed](https://skillfed.io/packages/opentelemetry-instrumentation-grpc) · [View on PyPI](https://pypi.org/project/opentelemetry-instrumentation-grpc/)