---
id: opentelemetry-instrumentation-pinecone
version: "0.62.3"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# opentelemetry-instrumentation-pinecone — OpenTelemetry Pinecone instrumentation

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

## What it is and what it does

This package is an OpenTelemetry instrumentation plugin that automatically captures traces from calls made to Pinecone, the vector database client library. It integrates with the OpenTelemetry ecosystem to emit structured telemetry data about Pinecone operations, enabling distributed tracing and observability across your application.

You install it alongside your OpenTelemetry setup, call `PineconeInstrumentor().instrument()` once at startup, and from that point forward all Pinecone client calls are automatically traced. The traces flow into whatever OpenTelemetry exporter you have configured (e.g., Jaeger, Datadog, or a collector). It depends on the core OpenTelemetry API and instrumentation framework, plus semantic convention packages for AI operations.

Use it for:

- Debug slow or failing Pinecone queries by viewing full request/response traces in your observability backend.
- Correlate Pinecone operations with other application traces to understand end-to-end latency in RAG or vector search workflows.
- Monitor Pinecone usage patterns and performance metrics across your production deployments.
- Troubleshoot integration issues between your application and Pinecone by inspecting emitted span data.

## Worth the install?

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

Adds distributed tracing to Pinecone vector database client calls using OpenTelemetry, capturing request and response telemetry for observability.

Yes, if you are already using OpenTelemetry and Pinecone together. The package is actively maintained, has no known vulnerabilities, installs with low friction, and solves the specific problem of making Pinecone calls visible within your observability stack. Skip it if you are not using OpenTelemetry or do not need tracing for Pinecone operations.

## Install

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

## Installing opentelemetry-instrumentation-pinecone

Before you install: Low friction install with a small, focused dependency tree. Actively maintained with a recent release and no known vulnerabilities.

License in practice: Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install opentelemetry-instrumentation-pinecone

from opentelemetry.instrumentation.pinecone import PineconeInstrumentor

PineconeInstrumentor().instrument()

Requires Python 3.10 or later; requires an active OpenTelemetry SDK setup with a configured exporter to actually export traces.

Verify before relying:

- Whether the instrumentation works with all versions of the official Pinecone library or has specific version constraints.
- What specific trace attributes and span names are generated for different Pinecone operations.

## Package facts

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

## Tags

opentelemetry pinecone tracing, pinecone instrumentation, vector database observability, pinecone client tracing, distributed tracing vector db, opentelemetry instrumentation, pinecone telemetry, observability, vector-database, tracing

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