OtelTracingMiddleware

OtelTracingMiddleware creates event and handler spans with parent-child linking.

Constructor params

tracer / Tracer: optional explicit OpenTelemetry tracer instance.
trace_api: optional explicit opentelemetry.trace module in Python/TypeScript.
root_span_attributes / RootSpanAttributes: attributes added to top-level event spans.

Setup with EventBus

Python
TypeScript
Go
Rust

from abxbus import EventBus
from abxbus.middlewares import OtelTracingMiddleware

bus = EventBus(
    name='AppBus',
    middlewares=[OtelTracingMiddleware()],
)

import { EventBus } from 'abxbus'
import { OtelTracingMiddleware } from 'abxbus/OtelTracingMiddleware'

const bus = new EventBus('AppBus', {
  middlewares: [new OtelTracingMiddleware()],
})

// Not implemented in the core Go module.
// OpenTelemetry is intentionally not a required Go dependency.

// Not implemented in the Rust crate yet.
// Use typed event JSON serialization with an external transport for now.

Setup with Sentry

Python
Rust

import sentry_sdk
from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from sentry_sdk.integrations.opentelemetry import SentrySpanProcessor

from abxbus import EventBus
from abxbus.middlewares import OtelTracingMiddleware

sentry_sdk.init(
    dsn='https://<public>@<host>/<project>',
    traces_sample_rate=1.0,
)

provider = TracerProvider()
provider.add_span_processor(SentrySpanProcessor())
trace.set_tracer_provider(provider)

bus = EventBus(
    name='AppBus',
    middlewares=[OtelTracingMiddleware()],
)

Install requirements:

pip install sentry-sdk opentelemetry-api opentelemetry-sdk

// Not implemented in the Rust crate yet.
// Wire tracing around typed handlers directly until Rust middleware parity lands.

Behavior

Starts an event span when an event starts and ends it on completion.
Starts one child span per handler execution.
Records handler exceptions on handler spans.
Links child events to parent handler spans where available.
With Sentry OpenTelemetry integration enabled, these spans are exported to Sentry performance traces.

Getting Started

Features

API Reference

Concurrency Control

Integrations

Further Reading

OtelTracingMiddleware

Constructor params

Setup with EventBus

Setup with Sentry

Behavior

​Constructor params

​Setup with EventBus

​Setup with Sentry

​Behavior

Constructor params

Setup with EventBus

Setup with Sentry

Behavior