Ir al contenido
mofcloud

Monitorización

Última actualización:

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

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

Importar el dashboard

  1. Abre http://SERVER_IP:3000, inicia sesión como admin / admin y define una contraseña nueva.
  2. 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

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

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étricas

MétricaEtiquetasSignificado
mof_processesmodeProcesos vistos en los últimos 90 s, por modo (all-in-one, web, worker).
mof_account_sync_last_success_timestamp_secondsaccount, provider, dataCuándo se sincronizaron correctamente por última vez las facturas / los recursos. Un SyncAll cuenta para ambos.
mof_account_sync_failedaccount, provider, data1 cuando falló la última sincronización de esos datos.
mof_jobskind, stateTrabajos en segundo plano por tipo y estado (available, running, retryable, discarded…).
mof_license_expiry_timestamp_seconds / mof_license_validCuándo vence la licencia y si es válida.
mof_mcp_requests_totalmethod, resultLlamadas a la pasarela MCP remota.
mof_metrics_database_up0 cuando MOF no pudo leer su base de datos.
mof_http_requests_totalmethod, route, codeSolicitudes 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_secondsmethod, routeLatencia de la API (histograma, se suma entre procesos).
mof_users / mof_accountsstate / providerUsuarios (activos, deshabilitados) y cuentas en la nube por proveedor.
mof_database_size_bytesdatabaseTamañ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_goroutinesPool 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.

AlertaCuándo
MofDownMOF dejó de responder a los scrapes durante 2 minutos.
MofDatabaseUnreachableMOF no puede leer su base de datos.
MofAccountSyncFailingLas facturas o los recursos de una cuenta siguen sin sincronizarse (30 minutos).
MofAccountSyncStaleNinguna sincronización correcta de las facturas o los recursos de una cuenta en 36 horas.
MofJobsDiscardedTrabajos en segundo plano fallidos definitivamente en la última hora.
MofJobBacklogMás de 50 trabajos en espera durante 30 minutos: añade workers o busca uno atascado.
MofHighErrorRateMás del 5 % de las solicitudes a la API fallan con 5xx durante 10 minutos.
MofLicenseExpiringLa licencia vence en menos de 14 días.