# Monitoring (Prometheus + Grafana)

Minimal stack for KYC monitoring status based on Prometheus metrics.

## Services
- `kyc-monitoring-exporter`: queries Postgres and exposes `/metrics`.
- `prometheus`: scrapes exporter and stores time series.
- `grafana`: dashboards and alerts.

## Metrics
- `kyc_monitoring_total`
- `kyc_monitoring_stale`
- `kyc_monitoring_fresh`
- `kyc_monitoring_stale_ratio`

## Metrics source
Prometheus scrapes the KYC service `/metrics` endpoint. Update the target in
`prometheus/prometheus.yml` if the service name/port differs.

## Env vars
KYC database credentials belong to the KYC service (store via Infisical).

## Run
`docker compose up -d`

Grafana home dashboard is provisioned from `grafana/dashboards/kyc_monitoring.json`.
