Zum Inhalt springen
mofcloud

Monitoring

Zuletzt aktualisiert:

MOF stellt Prometheus-Metriken bereit: Prozesse, ob Rechnungen und Ressourcen synchronisiert werden, Hintergrundjobs, die Lizenz, HTTP- und MCP-Verkehr. Stellen Sie Prometheus und Grafana daneben oder richten Sie Ihre vorhandenen darauf aus.

Voraussetzungen
MOF v2.0.14+
Metrik-Endpunkt
http://mof:8080/internal/v1/mof/metrics
Erreichbarkeit
Nur intern: Dash leitet diesen Pfad nicht weiter.

Docker Compose

Fügt Prometheus und Grafana neben MOF hinzu. Prometheus bringt die Alert-Regeln von MOF mit, Grafana Prometheus als Datenquelle.

Herunterladen

Legen Sie beide neben Ihre compose.yaml.

Starten

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

Dashboard importieren

  1. Öffnen Sie http://SERVER_IP:3000, melden Sie sich als admin / admin an und legen Sie ein neues Passwort fest.
  2. Dashboards → Neu → Importieren → Dashboard-JSON-Datei hochladen, und wählen Sie mof-grafana-dashboard.json.
  • Erlauben Sie Port 3000 nur aus Ihrem eigenen Netzwerk.
  • Etwa 300 MB mehr Speicher; Prometheus behält Daten 15 Tage. Images: prom/prometheus:v2.53.1, grafana/grafana:11.1.0; Docker Compose v2.23+.
  • Geben Sie beide Dateien auch bei späteren Befehlen an (pull, up -d), sonst fehlen die Monitoring-Services.

Vorhandenes Prometheus und Grafana

DateiVerwendung
prometheus.yml ↓Scrape-Job für MOF. Prometheus muss Port 8080 von MOF über Ihr privates Netzwerk erreichen.
mof-alerts.yml ↓Alert-Regeln; fügen Sie die Datei unter rule_files hinzu.
mof-grafana-dashboard.json ↓In Grafana importieren und Ihre Prometheus-Datenquelle wählen.

Bei mehreren Web-Prozessen meldet jeder die Werte des gesamten Deployments (Prozesse, Synchronisierungen, Jobs); Dashboard und Regeln verwenden max(), daher ist es kein Problem, alle zu scrapen. Worker bieten kein HTTP; ihre Arbeit erscheint über die Web-Prozesse.

Kubernetes

Die MOF-Pods tragen die üblichen prometheus.io-Annotationen (scrape, Port 8080, path), sodass ein Prometheus, das Pods per Annotation erkennt, sie erfasst. Mit dem Prometheus Operator fügen Sie einen PodMonitor hinzu:

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

Metriken

MetrikLabelsBedeutung
mof_processesmodeProzesse, die in den letzten 90 s gesehen wurden, nach Modus (all-in-one, web, worker).
mof_account_sync_last_success_timestamp_secondsaccount, provider, dataWann Rechnungen / Ressourcen zuletzt erfolgreich synchronisiert wurden. Ein SyncAll zählt für beide.
mof_account_sync_failedaccount, provider, data1, wenn die letzte Synchronisierung dieser Daten fehlgeschlagen ist.
mof_jobskind, stateHintergrundjobs nach Art und Zustand (available, running, retryable, discarded…).
mof_license_expiry_timestamp_seconds / mof_license_validWann die Lizenz endet und ob sie gültig ist.
mof_mcp_requests_totalmethod, resultAufrufe des Remote-MCP-Gateways.
mof_metrics_database_up0, wenn MOF seine Datenbank nicht lesen konnte.
mof_http_requests_totalmethod, route, codeAPI-Anfragen. route ist das Routen-Template (/v1/mof/prov/account/:accountId/bills), sodass IDs und Scanner keine neuen Serien erzeugen; unbekannte Pfade zählen als unmatched.
mof_http_request_duration_secondsmethod, routeAPI-Latenz (Histogramm, über Prozesse summierbar).
mof_users / mof_accountsstate / providerBenutzer (aktiv, deaktiviert) und Cloud-Konten nach Anbieter.
mof_database_size_bytesdatabaseGröße jeder von MOF verwalteten Datenbank: Mof und die Rechnungsdatenbanken der Anbieter, die mit Konten und Monaten wachsen.
go_sql_*, go_memstats_*, go_goroutinesDatenbank-Verbindungspool und Go-Runtime.

Alerts

In mof-alerts.yml. Prometheus wertet sie aus; leiten Sie sie mit Ihrem Alertmanager weiter oder sehen Sie sie in Grafana → Alerting an.

AlertWann
MofDownMOF hat 2 Minuten lang nicht auf Scrapes geantwortet.
MofDatabaseUnreachableMOF kann seine Datenbank nicht lesen.
MofAccountSyncFailingRechnungen oder Ressourcen eines Kontos schlagen bei der Synchronisierung wiederholt fehl (30 Minuten).
MofAccountSyncStaleSeit 36 Stunden keine erfolgreiche Synchronisierung der Rechnungen oder Ressourcen eines Kontos.
MofJobsDiscardedHintergrundjobs sind in der letzten Stunde endgültig fehlgeschlagen.
MofJobBacklogMehr als 50 Jobs warten seit 30 Minuten: Worker hinzufügen oder nach einem hängenden suchen.
MofHighErrorRateMehr als 5 % der API-Anfragen schlagen 10 Minuten lang mit 5xx fehl.
MofLicenseExpiringDie Lizenz endet in weniger als 14 Tagen.