# blueswen/fastapi-observability

Observe FastAPI app with three pillars of observability: Traces (Tempo), Metrics (Prometheus), Logs (Loki) on Grafana through OpenTelemetry.

Repository: https://github.com/blueswen/fastapi-observability
Canonical: https://ross.abutalabs.com/products/fastapi-observability
Language: Python
License: MIT
License Family: permissive
Topics: fastapi, grafana, loki, opentelemetry, prometheus, tempo, openmetrics, observability
Last push: 2026-04-12T05:52:53+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 77, release rhythm 35, longevity 100
- inputs: {"age_days": 1603, "days_push": 143, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1116, forks 142 (observed 2026-08-28T04:03:38.737683+00:00)

## What it is
A Docker Compose-based reference setup that instruments a FastAPI application with the three pillars of observability: traces via Tempo and OpenTelemetry, metrics via Prometheus, and logs via Loki, all visualized in Grafana. It ships preconfigured dashboards with correlated metrics-to-traces-to-logs navigation.

## Use cases
- add observability to a fastapi app
- set up prometheus metrics for fastapi
- collect traces with opentelemetry and tempo
- ship application logs to loki
- correlate metrics traces and logs in grafana
- example grafana dashboards for python web services

## When to choose
- you run a FastAPI service and want a ready-made Grafana observability stack
- you want to learn how traces, metrics, and logs integrate via OpenTelemetry
- you want prebuilt dashboards with metrics-to-traces and logs-to-traces correlation

## When to avoid
- your app is not FastAPI or Python-based
- you use a different observability backend like Datadog or New Relic
- you need a production-hardened solution rather than a reference/demo setup

## Facets
- artifact type: infra-config
- maturity: active
- function: monitoring, tracing, logging
- domain: monitoring, backend, web-development, developer-tools
- platform: python, self-hosted
- tags: fastapi, grafana, prometheus, loki, tempo, opentelemetry, docker-compose, three-pillars-of-observability, devops, docker, web-server

## Member repositories
- blueswen/fastapi-observability (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:38.737683+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:41:57.288950+00:00, confidence not recorded.
  - readme: https://github.com/blueswen/fastapi-observability (fetched 2026-08-28T04:03:38.737683+00:00, sha 430e40486017)
- Data as of 2026-08-30T08:39:29.467469+00:00.