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

# opentelemetry-instrumentation-falcon — Falcon instrumentation for OpenTelemetry

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

## What it is and what it does

This package integrates OpenTelemetry tracing into Falcon web applications by wrapping the WSGI middleware layer. It automatically creates and manages spans for incoming HTTP requests, capturing request and response metadata. You install it alongside your Falcon app, call FalconInstrumentor().instrument() at startup, and it begins recording traces that can be exported to any OpenTelemetry-compatible backend (Jaeger, Datadog, etc.).

The instrumentation supports filtering URLs from tracing via regex patterns and extracting custom request attributes as span tags. It also provides request and response hooks for adding application-specific logic to spans. The package depends on the core OpenTelemetry API and instrumentation framework, plus WSGI middleware support and semantic conventions for standardized span naming.

Use it for:

- Trace HTTP request latency and dependencies in Falcon microservices for performance debugging.
- Exclude health-check or internal endpoints from tracing to reduce noise in observability systems.
- Extract custom request attributes (query strings, URI templates) and attach them as span metadata.
- Correlate Falcon request traces with downstream service calls using trace context propagation.
- Monitor Falcon application behavior in production by exporting traces to a centralized collector.

## Worth the install?

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

Adds distributed tracing to Falcon web applications by instrumenting HTTP requests and responses with OpenTelemetry spans.

Yes, if you are running Falcon and need distributed tracing. The package is actively maintained, has low install friction, and integrates cleanly with the OpenTelemetry ecosystem. The beta status warrants checking release notes before upgrading in production, but it is widely used (top 5000 PyPI packages) and carries no known vulnerabilities. Install it when you have a tracing backend ready to receive spans.

## Install

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

## Installing opentelemetry-instrumentation-falcon

Before you install: Low friction install with six runtime dependencies. The package is actively maintained with recent releases and a stable upstream repository, though it carries a beta status (0.65b0) that may indicate ongoing API refinement.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and private projects with minimal restrictions beyond attribution and license inclusion.

Quickstart:

pip install opentelemetry-instrumentation-falcon

from opentelemetry.instrumentation.falcon import FalconInstrumentor
import falcon

FalconInstrumentor().instrument()
app = falcon.App()

Requires Python 3.10 or later; requires a configured OpenTelemetry exporter and collector to actually export traces.

Verify before relying:

- Whether the beta version (0.65b0) indicates planned breaking changes or API instability.
- Performance overhead of instrumentation on high-throughput Falcon applications.
- Compatibility with Falcon versions beyond what the instrumentation was tested against.

## Package facts

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

## Tags

falcon web tracing, opentelemetry falcon instrumentation, distributed tracing falcon apps, falcon request span tracking, opentelemetry wsgi middleware falcon, falcon http request monitoring, observability, distributed-tracing, falcon-framework

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