Monitoring

Overené podľa monitoring/* a src/app/observability/* dňa 2026-05-31.

Stack

Aktuálny monitoring profil (docker compose --profile monitoring) spúšťa:

Prometheus
Grafana
Jaeger

flowchart LR
    API["FastAPI /metrics"] --> Prom["Prometheus"]
    W["Worker metrics"] --> Prom
    Prom --> Graf["Grafana"]
    API -. "OTLP" .-> J["Jaeger"]
    W -. "OTLP" .-> J

Prístupy a Spustenie

Lokálny vývoj (Local Development)

Pre spustenie monitoringu lokálne:

Bash
docker compose --profile monitoring up -d

Bash
1	`docker compose --profile monitoring up -d`

Lokálne prístupy (bez nutnosti autentifikácie): - Grafana: http://localhost:3000 (alebo http://localhost:3000/grafana/) - Prometheus: http://localhost:9090 - Jaeger: http://localhost:16686 (alebo http://localhost:16686/jaeger/)

Produkčné prostredie (Production)

V produkcii sú služby monitoringu zabezpečené cez reverse proxy (Caddy) a vyžadujú Basic Auth. - Grafana: https://gitpulse.kpi.fei.tuke.sk/grafana/ - Prometheus: https://gitpulse.kpi.fei.tuke.sk/prometheus/ - Jaeger: https://gitpulse.kpi.fei.tuke.sk/jaeger/

Prihlasovacie údaje pre Basic Auth (Caddy): - Používateľ: admin - Heslo: GitPulse2026!

(Poznámka: Interné heslo administrátora Grafany je rovnaké: GitPulse2026!)

Kľúčové metriky (implementované)

Metrika	Typ	Labely	Význam
`webhook_events_received_total`	Counter	`event_type`	prijaté webhooky
`webhook_events_processed_total`	Counter	`event_type`, `status`	výsledok spracovania
`webhook_processing_duration_seconds`	Histogram	`event_type`	latencia spracovania
`gitlab_api_requests_total`	Counter	`endpoint`, `status`	volania na GitLab API
`gitlab_api_duration_seconds`	Histogram	`endpoint`	latencia GitLab API
`http_requests_total`	Counter	`method`, `path`, `status`	HTTP request objem
`http_request_duration_seconds`	Histogram	`method`, `path`	HTTP latencia
`rq_queue_depth`	Gauge	`queue_name`	hĺbka queue
`rq_failed_jobs_total`	Gauge	-	počet failed jobov
`rq_workers_active`	Gauge	-	aktívni workeri
`metrics_compute_total`	Counter	`status`	výpočty metrík
`metrics_compute_duration_seconds`	Histogram	-	čas výpočtu metrík
`db_pool_size`	Gauge	-	veľkosť DB poolu
`db_pool_checked_out`	Gauge	-	využité DB connections

Grafana dashboard

Provisioned dashboard:

monitoring/grafana/dashboards/gitpulse.json

Hlavné panely:

Webhook rate (received/processed)
Processing latency (p50/p95/p99)
Queue depth
Success/failure rate
DB pool utilization
HTTP request rate
GitLab API latency
Active workers
Metrics compute duration

Alerty

Alert pravidlá: monitoring/prometheus/alerts.yml

Alert	Podmienka
`QueueStuck`	`rq_queue_depth > 50` počas 5 min
`HighFailureRate`	`rate(webhook_events_processed_total{status="error"}[5m]) > 0.1`
`DatabaseDown`	`up{job="gitpulse-api"} == 0`
`HighProcessingLatency`	p95 webhook latencia > 10 s
`WorkerDown`	`rq_workers_active == 0`
`DBPoolExhausted`	`db_pool_checked_out / db_pool_size > 0.9`
`HighHTTPErrorRate`	podiel 5xx > 5%

Operačný checklist

/health a /metrics vracajú 200.
http://localhost:9090/targets má gitpulse-api v stave UP.
Grafana datasource smeruje na http://prometheus:9090.
Pri incidentoch korelujte correlation_id medzi logmi, metrikami a trace.