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

# opentelemetry-instrumentation-pyramid — OpenTelemetry Pyramid instrumentation

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

## What it is and what it does

OpenTelemetry Pyramid Instrumentation is a plugin that automatically hooks into Pyramid web applications to emit distributed tracing and metrics data. It wraps HTTP request handling to capture request/response details, timing, and errors without requiring changes to your application code. The package sits on top of the OpenTelemetry API and instrumentation framework, using WSGI instrumentation as its foundation.

Once installed and initialized, it collects observability signals that can be exported to tracing backends (Jaeger, Zipkin, etc.) or metrics systems. It's part of the OpenTelemetry Python contrib ecosystem and targets developers building Pyramid applications who need visibility into request flows, latency, and error rates across distributed systems.

Use it for:

- Instrument a Pyramid microservice to emit traces to a central tracing backend for request flow visualization.
- Collect HTTP request metrics (latency, error rates, throughput) from a Pyramid application for alerting.
- Debug slow endpoints in a Pyramid app by correlating traces with application logs via trace IDs.
- Monitor a Pyramid service in a distributed system to track cross-service request propagation.
- Gather performance baselines on Pyramid endpoints before and after code changes.

## Worth the install?

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

Adds automatic tracing and metrics collection to Pyramid web applications via OpenTelemetry, capturing HTTP requests, responses, and performance data without modifying application code.

Yes, if you run Pyramid applications and need observability. The package is actively maintained, has low install friction, carries a permissive license, and integrates cleanly with the OpenTelemetry ecosystem. No known vulnerabilities. The main condition is that you have an OpenTelemetry exporter configured to actually send the collected data somewhere—the instrumentation alone emits signals but does not export them by default.

## Install

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

## Installing opentelemetry-instrumentation-pyramid

Before you install: Low friction install with a wheel distribution. Actively maintained as of 2026-07-16 with recent activity. Depends on six OpenTelemetry core packages (opentelemetry-api, opentelemetry-instrumentation, opentelemetry-semantic-conventions, opentelemetry-util-http, opentelemetry-instrumentation-wsgi, wrapt), all standard instrumentation infrastructure.

License in practice: Apache-2.0 permissive license allows use in commercial and proprietary projects with minimal restrictions—include a copy of the license and note any material modifications.

Quickstart:

pip install opentelemetry-instrumentation-pyramid

from pyramid.config import Configurator
from opentelemetry.instrumentation.pyramid import PyramidInstrumentor

PyramidInstrumentor().instrument()

config = Configurator()
# ... configure your Pyramid app

Requires Python 3.10 or later; Pyramid application must be configured after instrumentation is initialized.

Verify before relying:

- Whether instrumentation works with Pyramid versions prior to the package's first release in 2020-08-14.
- Specific OpenTelemetry exporters or backends required to actually send traces and metrics somewhere.
- Performance overhead of instrumentation in production workloads.

## Package facts

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

## Tags

pyramid web framework tracing, opentelemetry pyramid instrumentation, automatic http request monitoring, distributed tracing pyramid apps, pyramid performance metrics, wsgi instrumentation, observability pyramid framework, observability, distributed-tracing, pyramid-framework

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