MOF expone métricas de Prometheus: procesos, si las facturas y los recursos se están sincronizando, trabajos en segundo plano, la licencia y el tráfico HTTP y MCP. Añade Prometheus y Grafana junto a él, o apunta los que ya tienes hacia él.
- Requisitos
- MOF v2.0.14+
- Endpoint de métricas
http://mof:8080/internal/v1/mof/metrics- Exposición
- Solo interno: Dash no reenvía esta ruta.
Docker Compose
Añade Prometheus y Grafana junto a MOF. Prometheus incluye las reglas de alerta de MOF y Grafana, Prometheus como fuente de datos.
Descargar
Pon ambos junto a tu compose.yaml.
Iniciar
docker compose -f compose.yaml -f compose.monitoring.yaml up -dImportar el dashboard
- Abre
http://SERVER_IP:3000, inicia sesión como admin / admin y define una contraseña nueva. - Dashboards → New → Import → Upload dashboard JSON file, y elige mof-grafana-dashboard.json.
- Permite el puerto 3000 solo desde tu propia red.
- Unos 300 MB más de memoria; Prometheus conserva 15 días de datos. Imágenes:
prom/prometheus:v2.53.1,grafana/grafana:11.1.0; Docker Compose v2.23+. - Pasa ambos archivos también en los comandos posteriores (pull, up -d), o los servicios de monitorización quedarán fuera.
Prometheus y Grafana existentes
| Archivo | Uso |
|---|---|
| prometheus.yml ↓ | Job de scrape para MOF. Prometheus debe alcanzar el puerto 8080 de MOF a través de tu red privada. |
| mof-alerts.yml ↓ | Reglas de alerta; añádelo en rule_files. |
| mof-grafana-dashboard.json ↓ | Impórtalo en Grafana y elige tu fuente de datos de Prometheus. |
Con varios procesos web, cada uno informa los valores de todo el despliegue (procesos, sincronizaciones, trabajos); el dashboard y las reglas usan max(), así que se pueden hacer scrapes de todos. Los workers no sirven HTTP; su trabajo aparece a través de los procesos web.
Kubernetes
Los Pods de MOF llevan las anotaciones prometheus.io habituales (scrape, puerto 8080, path), así que un Prometheus que descubre Pods por anotación los detecta. Con Prometheus Operator, añade 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étricas
| Métrica | Etiquetas | Significado |
|---|---|---|
mof_processes | mode | Procesos vistos en los últimos 90 s, por modo (all-in-one, web, worker). |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | Cuándo se sincronizaron correctamente por última vez las facturas / los recursos. Un SyncAll cuenta para ambos. |
mof_account_sync_failed | account, provider, data | 1 cuando falló la última sincronización de esos datos. |
mof_jobs | kind, state | Trabajos en segundo plano por tipo y estado (available, running, retryable, discarded…). |
mof_license_expiry_timestamp_seconds / mof_license_valid | Cuándo vence la licencia y si es válida. | |
mof_mcp_requests_total | method, result | Llamadas a la pasarela MCP remota. |
mof_metrics_database_up | 0 cuando MOF no pudo leer su base de datos. | |
mof_http_requests_total | method, route, code | Solicitudes a la API. route es la plantilla de ruta (/v1/mof/prov/account/:accountId/bills), así que los IDs y los escáneres que sondean no añaden series; las rutas desconocidas cuentan como unmatched. |
mof_http_request_duration_seconds | method, route | Latencia de la API (histograma, se suma entre procesos). |
mof_users / mof_accounts | state / provider | Usuarios (activos, deshabilitados) y cuentas en la nube por proveedor. |
mof_database_size_bytes | database | Tamaño de cada base de datos que gestiona MOF: Mof y las bases de datos de facturas de los proveedores, que crecen con las cuentas y los meses. |
go_sql_*, go_memstats_*, go_goroutines | Pool de conexiones a la base de datos y runtime de Go. |
Alertas
En mof-alerts.yml. Prometheus las evalúa; enrútalas con tu Alertmanager o consúltalas en Grafana → Alerting.
| Alerta | Cuándo |
|---|---|
MofDown | MOF dejó de responder a los scrapes durante 2 minutos. |
MofDatabaseUnreachable | MOF no puede leer su base de datos. |
MofAccountSyncFailing | Las facturas o los recursos de una cuenta siguen sin sincronizarse (30 minutos). |
MofAccountSyncStale | Ninguna sincronización correcta de las facturas o los recursos de una cuenta en 36 horas. |
MofJobsDiscarded | Trabajos en segundo plano fallidos definitivamente en la última hora. |
MofJobBacklog | Más de 50 trabajos en espera durante 30 minutos: añade workers o busca uno atascado. |
MofHighErrorRate | Más del 5 % de las solicitudes a la API fallan con 5xx durante 10 minutos. |
MofLicenseExpiring | La licencia vence en menos de 14 días. |