What problem does it solve?
Provide engineers with practical patterns to answer what happened, where it happened, and why in production by adding structured logs, request-level metrics, and distributed traces so incidents can be diagnosed without redeploying code.
Core Features & Use Cases
- Structured JSON logging for machine-readable, queryable logs with consistent fields and semantic log levels.
- Metrics instrumentation using Prometheus primitives to track latency, traffic, errors, and saturation with bounded label cardinality.
- Distributed tracing via OpenTelemetry with OTLP export and span propagation across service boundaries.
- Correlation ID propagation via contextvars and middleware to link logs, metrics, and traces end-to-end.
- Reusable patterns such as timing context managers, decorators for request tracking, and guidance for testing observability pipelines.
Quick Start
Instrument my FastAPI service with structlog JSON logging, add Prometheus metrics for HTTP requests and errors, and configure OpenTelemetry tracing with middleware and an OTLP exporter.