How rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria works
This repository is a FastAPI cafeteria inventory service. Clients can order coffee, decrementing stock, or reload stock; both operations use SQLAlchemy sessions and the Product model backed by PostgreSQL. The app also initializes coffee at startup, exposes readiness and root endpoints, and configures metrics, tracing, and application logging. The README names NGINX and a Prometheus/Grafana/Loki/Promtail observability stack, but their runtime wiring is not shown in the excerpts, so those connections are omitted or marked unverified.
Main entry points: main.py FastAPI app · models.py Product model · database.py DB sessions · promtail-config.yaml Promtail
Components 18
Inventory API
- FastAPI app
main.py - Order coffee
main.py - Reload stock
main.py - Stock initialization
main.py - Readiness check
main.py
Persistence
- Product model
models.py - DB sessions
database.py - PostgreSQL
Observability
- Metrics instrumentation
main.py - Trace exporter
main.py - Tempo
- Application logging
main.py - Prometheus
prometheus.yml - Grafana
- Promtail
promtail-config.yaml - Loki
Traffic
- NGINX
nginx.conf
Other components
- API client
Connections 20
- API client → FastAPI app: sends requests
main.py - FastAPI app → Order coffee: routes to
main.py - FastAPI app → Reload stock: routes to
main.py - FastAPI app → Stock initialization: runs at startup
main.py - FastAPI app → Readiness check: routes to
main.py - Order coffee → Product model: queries and updates
main.py - Reload stock → Product model: queries and updates
main.py - Stock initialization → Product model: queries and seeds
main.py - Readiness check → PostgreSQL: checks connection
main.py - FastAPI app → DB sessions: uses sessions
main.py - DB sessions → PostgreSQL: connects to
database.py - Product model → PostgreSQL: maps product table
models.py - FastAPI app → PostgreSQL: creates tables
main.py - FastAPI app → Metrics instrumentation: instruments routes
main.py - Metrics instrumentation → Prometheus: scrapes metrics
- FastAPI app → Trace exporter: configures tracing
main.py - Trace exporter → Tempo: exports spans
main.py - FastAPI app → Application logging: writes logs
main.py - Promtail → Loki: ships logs
- NGINX → FastAPI app: balances traffic