Aller au contenu
mofcloud

Supervision

Dernière mise à jour :

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

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

Importer le tableau de bord

  1. Ouvrez http://SERVER_IP:3000, connectez-vous en tant que admin / admin et définissez un nouveau mot de passe.
  2. 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

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

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

Métriques

MétriqueLabelsSignification
mof_processesmodeProcessus vus au cours des 90 dernières s, par mode (all-in-one, web, worker).
mof_account_sync_last_success_timestamp_secondsaccount, provider, dataDernière synchronisation réussie des factures / ressources. Un SyncAll compte pour les deux.
mof_account_sync_failedaccount, provider, data1 lorsque la dernière synchronisation de ces données a échoué.
mof_jobskind, stateTâches d’arrière-plan par type et état (available, running, retryable, discarded…).
mof_license_expiry_timestamp_seconds / mof_license_validDate de fin de la licence, et si elle est valide.
mof_mcp_requests_totalmethod, resultAppels à la passerelle MCP distante.
mof_metrics_database_up0 lorsque MOF n’a pas pu lire sa base de données.
mof_http_requests_totalmethod, route, codeRequê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_secondsmethod, routeLatence API (histogramme, cumulable entre processus).
mof_users / mof_accountsstate / providerUtilisateurs (actifs, désactivés) et comptes cloud par fournisseur.
mof_database_size_bytesdatabaseTaille 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_goroutinesPool 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.

AlerteCondition
MofDownMOF ne répond plus aux scrapes depuis 2 minutes.
MofDatabaseUnreachableMOF ne peut pas lire sa base de données.
MofAccountSyncFailingLa synchronisation des factures ou ressources d’un compte échoue de façon répétée (30 minutes).
MofAccountSyncStaleAucune synchronisation réussie des factures ou ressources d’un compte depuis 36 heures.
MofJobsDiscardedDes tâches d’arrière-plan ont définitivement échoué au cours de la dernière heure.
MofJobBacklogPlus de 50 tâches en attente depuis 30 minutes : ajoutez des workers ou cherchez une tâche bloquée.
MofHighErrorRatePlus de 5 % des requêtes API échouent en 5xx pendant 10 minutes.
MofLicenseExpiringLa licence expire dans moins de 14 jours.