Roadmap¶
Reviewed 20 November 2026, after the 2.5.0 release. Items have no dates. Shipped changes are in the changelog.
Where 2.5.0 stands¶
install_observability()gives a FastAPI app JSON request lines, zero-tracing diagnostics, Prometheus metrics and OpenTelemetry traces. The package is classified Production/Stable.- SQLAlchemy engines passed as
db_engine, and clients set up withinstrument_httpx_client()orinstrument_requests_session(), are counted on every request with tracing off. Other clients, such as Redis, are counted only from sampled OpenTelemetry client spans. fastapiobserver.experimental.observe_operation()observes code outside a request, such as a job or a CLI command. Itsoperation.*events follow the draft schema0.1.0inspec/. Both can change before promotion.- FastAPI and Starlette are required dependencies. The core and the operation
API import without them (
tests/test_core_imports.py), but a normal install still pulls them in.
Open work¶
- Lifecycle outside FastAPI: there is no setup or shutdown API for
operations. Code outside a FastAPI lifespan calls
setup_logging(),flush_logging()andshutdown_logging()itself and owns its OpenTelemetry providers. - Byte limits: a request holds at most 200 records, the queue at most
OBS_LOG_QUEUE_MAX_SIZErecords, and a message at most 32 KiB. Objects passed inextraor as non-string arguments are not measured. - Operations: writing held records for slow requests, and the
db.n_plus_one,db.slow_queryandhttp.n_plus_onewarnings, run for requests only;observe_operation()has none of them. - Datastore adapters: Redis (
redis-pysync and asyncio), PyMongo and Tortoise ORM need native hooks that count calls with tracing off, as the SQLAlchemy engine events do, plus tests against real servers. Each one starts when a real application needs it. - Other frameworks: a generic ASGI adapter, Flask (WSGI), Django and one worker framework such as Celery. Each starts when a user brings a real workload.
- Every change keeps the 2.2.1 compatibility fixture (baseline), the installed-wheel matrix and the release budgets passing.
Not scheduled¶
A framework-free core package with a versioned, language-neutral event
contract, so that TypeScript, Java, Go or Rust implementations can produce the
same events and share dashboards. spec/ holds the current draft. It needs a
second implementation, a maintainer for each language and real adopters before
it is planned.
Out of scope¶
A hosted backend, a custom Collector or transport protocol, a UI, business audit logs, health-check endpoints, profiling and browser telemetry.