Agent skill · software engineering · aiskillstore
py-observability
Observability patterns for Python backends. Use when adding logging, metrics, tracing, or debugging production issues.
Why this skill is useful
Provides specific structured logging patterns and middleware for Python backends that enhance observability and debugging capabilities.
What it needs
Requires fastapi, structlog installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Python Observability Problem Statement Production issues are impossible to debug without observability. Logging, metrics, and tracing must be built in from the start. Silent failures, missing context in errors, and lack of metrics make incidents last longer. --- Pattern: Structured Logging Problem: Unstructured logs are hard to search and analyze. structlog Configuration --- Pattern: Request Context Logging Problem: Logs from same request aren't correlated. --- Pattern: Log Levels --- Pattern: No Silent Early Returns Same principle as frontend - every early return should log: --- Pattern: Error Logging with Context --- Pattern: Prometheus Metrics Using Metrics --- Pattern: Sentry Error Tracking --- Pattern: Flow Tracing Problem: Multi-step operations where it's unclear how far execution got. --- Pattern: Health Checks --- Pattern: Sensitive Data Handling --- Observability Checklist When adding new features: [ ] Info logs for business events (created, submitted, completed) [ ] Warning logs for handled edge cases [ ] Error logs with full context for failures [ ] No silent early returns [ ] Metrics for key operations (counters, histograms) [ ] Flow tracing for multi-step operations [ ] Sensitive data redacted from logs [ ] Request ID in all logs [ ] Health check endpoints When debugging production: [ ] Can correlate logs by requestid [ ] Can find error in Sentry with context [ ] Can see metrics in Prometheus/Grafana [ ] Can trace operation through flowid
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/py-observability