Registry / devops / openfeature-hooks-opentelemetry

openfeature-hooks-opentelemetry

library0.3.1pypypiunverified

OpenTelemetry hooks for the OpenFeature Python SDK, enabling automatic telemetry (tracing) when flag evaluations occur. Currently at v0.3.1. Releases follow the OpenFeature Python SDK contrib release cadence.

devops observability

pip install openfeature-hooks-opentelemetry

github ↗homepage ↗

INSTALL

IMPORT

SIG · OPENFEATURE-HOOKS-

openfeature-hooks-opentelemetry

devopspythonv0.3.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

OpenTelemetryHook

✓ from openfeature.hooks import OpenTelemetryHook

✗ from openfeature_hooks_opentelemetry import OpenTelemetryHook

Add OpenTelemetry tracing to all flag evaluations by adding the hook globally.

from openfeature import api from openfeature_hooks_opentelemetry import OpenTelemetryHook hook = OpenTelemetryHook() api.add_hooks(hook) # Now every flag evaluation will create spans client = api.get_client() flag_value = client.get_boolean_value('my-feature', False) print(flag_value)

Debug

Known issues

breakingThis library requires OpenTelemetry SDK to be configured (e.g., exporter, sampler) otherwise spans may not be exported and you may see no telemetry. It does not auto-initialize OTel.

fix

Set up OpenTelemetry tracing (e.g., OTLP exporter) before evaluating flags. Example:
from opentelemetry import trace
from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
provider = TracerProvider()
provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter()))
trace.set_tracer_provider(provider)

affects: all

gotchaThe hook only instruments flag evaluations; it does NOT propagate context or manage trace headers. You must handle that separately (e.g., using OpenTelemetry propagators).

fix

Use opentelemetry-propagator-* packages and set propagator via otel_python_ propagator env vars or code.

affects: all

breakingAs of v0.3.0, the hook may require compatible OpenFeature SDK >= 1.7. Earlier versions may cause import errors or runtime failures.

fix

Ensure openfeature-sdk is at least 1.7.0.

affects: >=0.3.0

Upgrade

Version history

0.3.1latest on PyPI · released Feb 17, 2026

Audit

Dependencies

openfeature-sdkrequiredCore OpenFeature SDK required

opentelemetry-apirequiredOpenTelemetry API required

Agent activity

11 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/open-feature/python-sdk-contrib ↗

homepagehttps://github.com/open-feature/python-sdk-contrib ↗