title: Operations Guide description: Guide for deploying, monitoring, and maintaining a FraiseQL (Python/FastAPI/PostgreSQL) application in production. keywords: ["deployment", "monitoring", "performance", "observability", "troubleshooting"] tags: ["documentation", "reference"]
Operations Guide¶
Operating a FraiseQL application in production. FraiseQL builds its GraphQL schema in
memory at startup and serves it from a FastAPI app (run under an ASGI server such as
uvicorn) backed by PostgreSQL. These pages cover configuring observability, tracing,
and tuning query performance.
In This Section¶
- Observability — Metrics, logging, and health signals for the running FastAPI app.
- Distributed Tracing — Trace requests across the app and into PostgreSQL.
- Observability Configuration — Configuration reference for the observability features.
- Performance Tuning Runbook — Diagnose and optimize GraphQL/PostgreSQL query performance.
Related Guides¶
- Production Deployment — Deploy the FastAPI app to production.
- Monitoring — Day-to-day monitoring guidance.
- TLS Configuration — Terminate TLS for the app.
- Rate Limiting — Protect endpoints from abuse.
- PostgreSQL Authentication — Secure the database connection.
Running in Production¶
- Deploy — Run the FastAPI app under an ASGI server (
uvicorn app:app) following the Production Deployment guide. - Secure — Configure TLS, rate limiting, and PostgreSQL authentication.
- Observe — Enable observability and distributed tracing.
- Tune — Use the Performance Tuning Runbook to diagnose slow queries.
Support¶
- Troubleshooting: See the troubleshooting guide.