MOF espone metriche Prometheus: processi, se fatture e risorse si stanno sincronizzando, job in background, la licenza, il traffico HTTP e MCP. Aggiungi Prometheus e Grafana accanto a MOF, oppure punta su di esso quelli che hai già.
- Requisiti
- MOF v2.0.14+
- Endpoint delle metriche
http://mof:8080/internal/v1/mof/metrics- Esposizione
- Solo interno: Dash non inoltra questo percorso.
Docker Compose
Aggiunge Prometheus e Grafana accanto a MOF. Prometheus include le regole di alert di MOF, Grafana ha Prometheus come origine dati.
Scarica
Metti entrambi accanto al tuo compose.yaml.
Avvia
docker compose -f compose.yaml -f compose.monitoring.yaml up -dImporta la dashboard
- Apri
http://SERVER_IP:3000, accedi come admin / admin e imposta una nuova password. - Dashboards → New → Import → Upload dashboard JSON file, e scegli mof-grafana-dashboard.json.
- Consenti la porta 3000 solo dalla tua rete.
- Circa 300 MB di memoria in più; Prometheus conserva 15 giorni di dati. Immagini:
prom/prometheus:v2.53.1,grafana/grafana:11.1.0; Docker Compose v2.23+. - Passa entrambi i file anche nei comandi successivi (pull, up -d), altrimenti i servizi di monitoraggio restano esclusi.
Prometheus e Grafana esistenti
| File | Uso |
|---|---|
| prometheus.yml ↓ | Job di scrape per MOF. Prometheus deve raggiungere la porta 8080 di MOF tramite la tua rete privata. |
| mof-alerts.yml ↓ | Regole di alert; aggiungilo in rule_files. |
| mof-grafana-dashboard.json ↓ | Importa in Grafana e scegli la tua origine dati Prometheus. |
Con più processi web, ognuno riporta i valori dell'intero deployment (processi, sincronizzazioni, job); la dashboard e le regole usano max(), quindi fare lo scrape di tutti va bene. I worker non servono HTTP; il loro lavoro compare tramite i processi web.
Kubernetes
I Pod di MOF hanno le consuete annotazioni prometheus.io (scrape, porta 8080, path), quindi un Prometheus che scopre i Pod tramite annotazioni li rileva. Con Prometheus Operator, aggiungi un PodMonitor:
apiVersion: monitoring.coreos.com/v1
kind: PodMonitor
metadata:
name: mof
namespace: mof
spec:
selector:
matchLabels:
app: mof
podMetricsEndpoints:
- port: api
path: /internal/v1/mof/metrics
interval: 30sMetriche
| Metrica | Label | Significato |
|---|---|---|
mof_processes | mode | Processi visti negli ultimi 90 s, per modalità (all-in-one, web, worker). |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | Quando fatture / risorse sono state sincronizzate correttamente l'ultima volta. Un SyncAll vale per entrambe. |
mof_account_sync_failed | account, provider, data | 1 quando l'ultima sincronizzazione di quei dati non è riuscita. |
mof_jobs | kind, state | Job in background per tipo e stato (available, running, retryable, discarded…). |
mof_license_expiry_timestamp_seconds / mof_license_valid | Quando scade la licenza e se è valida. | |
mof_mcp_requests_total | method, result | Chiamate al gateway MCP remoto. |
mof_metrics_database_up | 0 quando MOF non è riuscito a leggere il proprio database. | |
mof_http_requests_total | method, route, code | Richieste API. route è il template della route (/v1/mof/prov/account/:accountId/bills), quindi ID e scanner di sondaggio non aggiungono serie; i percorsi sconosciuti contano come unmatched. |
mof_http_request_duration_seconds | method, route | Latenza API (istogramma, sommabile tra i processi). |
mof_users / mof_accounts | state / provider | Utenti (attivi, disabilitati) e account cloud per provider. |
mof_database_size_bytes | database | Dimensione di ogni database gestito da MOF: Mof e i database delle fatture dei provider, che crescono con gli account e i mesi. |
go_sql_*, go_memstats_*, go_goroutines | Pool di connessioni al database e runtime Go. |
Alert
In mof-alerts.yml. Prometheus le valuta; instradale con il tuo Alertmanager o visualizzale in Grafana → Alerting.
| Alert | Quando |
|---|---|
MofDown | MOF ha smesso di rispondere agli scrape per 2 minuti. |
MofDatabaseUnreachable | MOF non riesce a leggere il proprio database. |
MofAccountSyncFailing | Le fatture o le risorse di un account continuano a non sincronizzarsi (30 minuti). |
MofAccountSyncStale | Nessuna sincronizzazione riuscita delle fatture o delle risorse di un account da 36 ore. |
MofJobsDiscarded | Job in background falliti definitivamente nell'ultima ora. |
MofJobBacklog | Più di 50 job in attesa da 30 minuti: aggiungi worker o cerca un job bloccato. |
MofHighErrorRate | Più del 5% delle richieste API fallisce con 5xx per 10 minuti. |
MofLicenseExpiring | La licenza scade entro 14 giorni. |