Salta ai contenuti
mofcloud

Monitoraggio

Ultimo aggiornamento:

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

Terminal
docker compose -f compose.yaml -f compose.monitoring.yaml up -d

Importa la dashboard

  1. Apri http://SERVER_IP:3000, accedi come admin / admin e imposta una nuova password.
  2. 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

FileUso
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:

podmonitor.yaml
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: 30s

Metriche

MetricaLabelSignificato
mof_processesmodeProcessi visti negli ultimi 90 s, per modalità (all-in-one, web, worker).
mof_account_sync_last_success_timestamp_secondsaccount, provider, dataQuando fatture / risorse sono state sincronizzate correttamente l'ultima volta. Un SyncAll vale per entrambe.
mof_account_sync_failedaccount, provider, data1 quando l'ultima sincronizzazione di quei dati non è riuscita.
mof_jobskind, stateJob in background per tipo e stato (available, running, retryable, discarded…).
mof_license_expiry_timestamp_seconds / mof_license_validQuando scade la licenza e se è valida.
mof_mcp_requests_totalmethod, resultChiamate al gateway MCP remoto.
mof_metrics_database_up0 quando MOF non è riuscito a leggere il proprio database.
mof_http_requests_totalmethod, route, codeRichieste 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_secondsmethod, routeLatenza API (istogramma, sommabile tra i processi).
mof_users / mof_accountsstate / providerUtenti (attivi, disabilitati) e account cloud per provider.
mof_database_size_bytesdatabaseDimensione 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_goroutinesPool 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.

AlertQuando
MofDownMOF ha smesso di rispondere agli scrape per 2 minuti.
MofDatabaseUnreachableMOF non riesce a leggere il proprio database.
MofAccountSyncFailingLe fatture o le risorse di un account continuano a non sincronizzarsi (30 minuti).
MofAccountSyncStaleNessuna sincronizzazione riuscita delle fatture o delle risorse di un account da 36 ore.
MofJobsDiscardedJob in background falliti definitivamente nell'ultima ora.
MofJobBacklogPiù di 50 job in attesa da 30 minuti: aggiungi worker o cerca un job bloccato.
MofHighErrorRatePiù del 5% delle richieste API fallisce con 5xx per 10 minuti.
MofLicenseExpiringLa licenza scade entro 14 giorni.