MOF expose des métriques Prometheus : processus, synchronisation des factures et ressources, tâches d’arrière-plan, licence, trafic HTTP et MCP. Ajoutez Prometheus et Grafana à côté, ou pointez-y vos instances existantes.
- Prérequis
- MOF v2.0.14+
- Endpoint des métriques
http://mof:8080/internal/v1/mof/metrics- Exposition
- Interne uniquement : Dash ne transmet pas ce chemin.
Docker Compose
Ajoute Prometheus et Grafana à côté de MOF. Prometheus est livré avec les règles d’alerte de MOF, Grafana avec Prometheus comme source de données.
Télécharger
Placez les deux à côté de votre compose.yaml.
Démarrer
docker compose -f compose.yaml -f compose.monitoring.yaml up -dImporter le tableau de bord
- Ouvrez
http://SERVER_IP:3000, connectez-vous en tant que admin / admin et définissez un nouveau mot de passe. - Dashboards → New → Import → Upload dashboard JSON file, puis choisissez mof-grafana-dashboard.json.
- N’autorisez le port 3000 que depuis votre propre réseau.
- Environ 300 Mo de mémoire en plus ; Prometheus conserve 15 jours de données. Images :
prom/prometheus:v2.53.1,grafana/grafana:11.1.0; Docker Compose v2.23+. - Passez aussi les deux fichiers aux commandes suivantes (pull, up -d), sinon les services de supervision sont ignorés.
Prometheus et Grafana existants
| Fichier | Usage |
|---|---|
| prometheus.yml ↓ | Job de scrape pour MOF. Prometheus doit joindre le port 8080 de MOF via votre réseau privé. |
| mof-alerts.yml ↓ | Règles d’alerte ; ajoutez le fichier sous rule_files. |
| mof-grafana-dashboard.json ↓ | À importer dans Grafana en choisissant votre source de données Prometheus. |
Avec plusieurs processus web, chacun rapporte les valeurs de tout le déploiement (processus, synchronisations, tâches) ; le tableau de bord et les règles utilisent max(), il n’y a donc aucun problème à tous les scraper. Les workers ne servent pas d’HTTP ; leur travail apparaît via les processus web.
Kubernetes
Les Pods MOF portent les annotations prometheus.io habituelles (scrape, port 8080, path), donc un Prometheus qui découvre les Pods par annotation les prend en compte. Avec le Prometheus Operator, ajoutez 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: 30sMétriques
| Métrique | Labels | Signification |
|---|---|---|
mof_processes | mode | Processus vus au cours des 90 dernières s, par mode (all-in-one, web, worker). |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | Dernière synchronisation réussie des factures / ressources. Un SyncAll compte pour les deux. |
mof_account_sync_failed | account, provider, data | 1 lorsque la dernière synchronisation de ces données a échoué. |
mof_jobs | kind, state | Tâches d’arrière-plan par type et état (available, running, retryable, discarded…). |
mof_license_expiry_timestamp_seconds / mof_license_valid | Date de fin de la licence, et si elle est valide. | |
mof_mcp_requests_total | method, result | Appels à la passerelle MCP distante. |
mof_metrics_database_up | 0 lorsque MOF n’a pas pu lire sa base de données. | |
mof_http_requests_total | method, route, code | Requêtes API. route est le modèle de route (/v1/mof/prov/account/:accountId/bills), donc les ID et les scanners n’ajoutent pas de séries ; les chemins inconnus comptent comme unmatched. |
mof_http_request_duration_seconds | method, route | Latence API (histogramme, cumulable entre processus). |
mof_users / mof_accounts | state / provider | Utilisateurs (actifs, désactivés) et comptes cloud par fournisseur. |
mof_database_size_bytes | database | Taille de chaque base gérée par MOF : Mof et les bases de factures des fournisseurs, qui grossissent avec les comptes et les mois. |
go_sql_*, go_memstats_*, go_goroutines | Pool de connexions à la base et runtime Go. |
Alertes
Dans mof-alerts.yml. Prometheus les évalue ; routez-les avec votre Alertmanager ou consultez-les dans Grafana → Alerting.
| Alerte | Condition |
|---|---|
MofDown | MOF ne répond plus aux scrapes depuis 2 minutes. |
MofDatabaseUnreachable | MOF ne peut pas lire sa base de données. |
MofAccountSyncFailing | La synchronisation des factures ou ressources d’un compte échoue de façon répétée (30 minutes). |
MofAccountSyncStale | Aucune synchronisation réussie des factures ou ressources d’un compte depuis 36 heures. |
MofJobsDiscarded | Des tâches d’arrière-plan ont définitivement échoué au cours de la dernière heure. |
MofJobBacklog | Plus de 50 tâches en attente depuis 30 minutes : ajoutez des workers ou cherchez une tâche bloquée. |
MofHighErrorRate | Plus de 5 % des requêtes API échouent en 5xx pendant 10 minutes. |
MofLicenseExpiring | La licence expire dans moins de 14 jours. |