5.6.0 — 2026-09-30¶
← 5.7.0 | 5.5.2 → | ↑ 5.x series
Added¶
Configs - OpenTelemetry¶
- FastAPI operation spans flag - Added
OTEL.FASTAPI_OPERATION_SPANS_ENABLED(defaulttrue).- Controls FastAPI child spans for dependencies, the endpoint, serialization, and background tasks
- Only applies when
OTEL.TRACES_ENABLEDis true
Helpers - FastAPI¶
FastAPIUtils.build_otel_telemetry_config- Builds thetelemetryargument forFastAPI(...)from ArchiPy OTel settings.- Uses ArchiPy tracer and meter providers; a signal without a real provider is disabled
auto_configureand FastAPI log records stay off, since ArchiPy owns the exporters and logging handlerOTEL.FASTAPI_EXCLUDED_URLSpatterns are matched as regular expressions against the request path
Changed¶
Helpers - FastAPI¶
- Native FastAPI telemetry -
AppUtils.create_fastapi_appnow enables FastAPI's built-in OpenTelemetry support instead ofFastAPIInstrumentor.- The HTTP duration metric is now
http.server.request.duration(seconds), replacinghttp.server.duration(milliseconds); update dashboards and alerts - Span names stay
GET /path
- The HTTP duration metric is now
archipy[otel-fastapi]extra - Now requiresfastapi>=0.142.2instead ofopentelemetry-instrumentation-fastapi.
Removed¶
Helpers - FastAPI¶
FastAPIUtils.setup_otel- FastAPI readstelemetryonly in its constructor, so it cannot be applied to an existing app.- Migrate custom apps to
FastAPI(telemetry=FastAPIUtils.build_otel_telemetry_config(config))
- Migrate custom apps to
Tests¶
Tests - OpenTelemetry¶
- HTTP duration metric name - The FastAPI BDD step now asserts
http.server.request.duration.
Dependencies¶
- FastAPI - Raised the
fastapiextra floor to 0.142.2. - Lockfile refresh -
boto3,boto3-stubs, andbotocore1.43.105,charset-normalizer3.5.2,filelock4.0.7,googleapis-common-protos1.75.5,platformdirs4.12.2,virtualenv21.14.1.- Dropped
opentelemetry-instrumentation-fastapi,opentelemetry-instrumentation-asgi, andasgireffrom the lock
- Dropped