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
docker compose -f compose.yaml -f compose.monitoring.yaml up -dDashboard importieren
- Öffnen Sie
http://SERVER_IP:3000, melden Sie sich als admin / admin an und legen Sie ein neues Passwort fest. - 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
| Datei | Verwendung |
|---|---|
| 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:
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: 30sMetriken
| Metrik | Labels | Bedeutung |
|---|---|---|
mof_processes | mode | Prozesse, die in den letzten 90 s gesehen wurden, nach Modus (all-in-one, web, worker). |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | Wann Rechnungen / Ressourcen zuletzt erfolgreich synchronisiert wurden. Ein SyncAll zählt für beide. |
mof_account_sync_failed | account, provider, data | 1, wenn die letzte Synchronisierung dieser Daten fehlgeschlagen ist. |
mof_jobs | kind, state | Hintergrundjobs nach Art und Zustand (available, running, retryable, discarded…). |
mof_license_expiry_timestamp_seconds / mof_license_valid | Wann die Lizenz endet und ob sie gültig ist. | |
mof_mcp_requests_total | method, result | Aufrufe des Remote-MCP-Gateways. |
mof_metrics_database_up | 0, wenn MOF seine Datenbank nicht lesen konnte. | |
mof_http_requests_total | method, route, code | API-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_seconds | method, route | API-Latenz (Histogramm, über Prozesse summierbar). |
mof_users / mof_accounts | state / provider | Benutzer (aktiv, deaktiviert) und Cloud-Konten nach Anbieter. |
mof_database_size_bytes | database | Größe jeder von MOF verwalteten Datenbank: Mof und die Rechnungsdatenbanken der Anbieter, die mit Konten und Monaten wachsen. |
go_sql_*, go_memstats_*, go_goroutines | Datenbank-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.
| Alert | Wann |
|---|---|
MofDown | MOF hat 2 Minuten lang nicht auf Scrapes geantwortet. |
MofDatabaseUnreachable | MOF kann seine Datenbank nicht lesen. |
MofAccountSyncFailing | Rechnungen oder Ressourcen eines Kontos schlagen bei der Synchronisierung wiederholt fehl (30 Minuten). |
MofAccountSyncStale | Seit 36 Stunden keine erfolgreiche Synchronisierung der Rechnungen oder Ressourcen eines Kontos. |
MofJobsDiscarded | Hintergrundjobs sind in der letzten Stunde endgültig fehlgeschlagen. |
MofJobBacklog | Mehr als 50 Jobs warten seit 30 Minuten: Worker hinzufügen oder nach einem hängenden suchen. |
MofHighErrorRate | Mehr als 5 % der API-Anfragen schlagen 10 Minuten lang mit 5xx fehl. |
MofLicenseExpiring | Die Lizenz endet in weniger als 14 Tagen. |