O MOF expõe métricas do Prometheus: processos, se faturas e recursos estão sincronizando, jobs em segundo plano, a licença e o tráfego HTTP e MCP. Adicione Prometheus e Grafana ao lado dele ou aponte os que você já tem para ele.
- Requisitos
- MOF v2.0.14+
- Endpoint de métricas
http://mof:8080/internal/v1/mof/metrics- Exposição
- Somente interno: o Dash não encaminha este caminho.
Docker Compose
Adiciona Prometheus e Grafana ao lado do MOF. O Prometheus vem com as regras de alerta do MOF, e o Grafana com o Prometheus como fonte de dados.
Download
Coloque ambos ao lado do seu compose.yaml.
Iniciar
docker compose -f compose.yaml -f compose.monitoring.yaml up -dImportar o dashboard
- Abra
http://SERVER_IP:3000, entre como admin / admin e defina uma nova senha. - Dashboards → New → Import → Upload dashboard JSON file, e escolha mof-grafana-dashboard.json.
- Permita a porta 3000 apenas a partir da sua própria rede.
- Cerca de 300 MB a mais de memória; o Prometheus mantém 15 dias de dados. Imagens:
prom/prometheus:v2.53.1,grafana/grafana:11.1.0; Docker Compose v2.23+. - Passe os dois arquivos também nos comandos seguintes (pull, up -d), ou os serviços de monitoramento ficarão de fora.
Prometheus e Grafana existentes
| Arquivo | Uso |
|---|---|
| prometheus.yml ↓ | Job de scrape para o MOF. O Prometheus precisa alcançar a porta 8080 do MOF pela sua rede privada. |
| mof-alerts.yml ↓ | Regras de alerta; adicione-o em rule_files. |
| mof-grafana-dashboard.json ↓ | Importe no Grafana e escolha sua fonte de dados do Prometheus. |
Com vários processos web, cada um informa os valores de toda a implantação (processos, sincronizações, jobs); o dashboard e as regras usam max(), então fazer scrape de todos não é problema. Workers não servem HTTP; o trabalho deles aparece pelos processos web.
Kubernetes
Os Pods do MOF têm as anotações prometheus.io habituais (scrape, porta 8080, path), então um Prometheus que descobre Pods por anotação os encontra. Com o Prometheus Operator, adicione um 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 | Labels | Significado |
|---|---|---|
mof_processes | mode | Processos vistos nos últimos 90 s, por modo (all-in-one, web, worker). |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | Quando faturas / recursos foram sincronizados com sucesso pela última vez. Um SyncAll conta para ambos. |
mof_account_sync_failed | account, provider, data | 1 quando a última sincronização desses dados falhou. |
mof_jobs | kind, state | Jobs em segundo plano por tipo e estado (available, running, retryable, discarded…). |
mof_license_expiry_timestamp_seconds / mof_license_valid | Quando a licença vence e se ela é válida. | |
mof_mcp_requests_total | method, result | Chamadas ao gateway MCP remoto. |
mof_metrics_database_up | 0 quando o MOF não conseguiu ler o banco de dados. | |
mof_http_requests_total | method, route, code | Requisições à API. route é o template da rota (/v1/mof/prov/account/:accountId/bills), então IDs e scanners de sondagem não criam séries; caminhos desconhecidos contam como unmatched. |
mof_http_request_duration_seconds | method, route | Latência da API (histograma, somável entre processos). |
mof_users / mof_accounts | state / provider | Usuários (ativos, desativados) e contas de nuvem por provedor. |
mof_database_size_bytes | database | Tamanho de cada banco de dados gerenciado pelo MOF: Mof e os bancos de faturas dos provedores, que crescem com as contas e os meses. |
go_sql_*, go_memstats_*, go_goroutines | Pool de conexões do banco de dados e runtime do Go. |
Alertas
Em mof-alerts.yml. O Prometheus as avalia; encaminhe-as com seu Alertmanager ou veja-as em Grafana → Alerting.
| Alerta | Quando |
|---|---|
MofDown | O MOF parou de responder aos scrapes por 2 minutos. |
MofDatabaseUnreachable | O MOF não consegue ler o banco de dados. |
MofAccountSyncFailing | As faturas ou os recursos de uma conta continuam falhando ao sincronizar (30 minutos). |
MofAccountSyncStale | Nenhuma sincronização bem-sucedida das faturas ou dos recursos de uma conta em 36 horas. |
MofJobsDiscarded | Jobs em segundo plano que falharam definitivamente na última hora. |
MofJobBacklog | Mais de 50 jobs aguardando por 30 minutos: adicione workers ou procure um travado. |
MofHighErrorRate | Mais de 5% das requisições à API falham com 5xx por 10 minutos. |
MofLicenseExpiring | A licença vence em até 14 dias. |