Pular para o conteúdo
mofcloud

Monitoramento

Última atualização:

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

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

Importar o dashboard

  1. Abra http://SERVER_IP:3000, entre como admin / admin e defina uma nova senha.
  2. 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

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

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étricaLabelsSignificado
mof_processesmodeProcessos vistos nos últimos 90 s, por modo (all-in-one, web, worker).
mof_account_sync_last_success_timestamp_secondsaccount, provider, dataQuando faturas / recursos foram sincronizados com sucesso pela última vez. Um SyncAll conta para ambos.
mof_account_sync_failedaccount, provider, data1 quando a última sincronização desses dados falhou.
mof_jobskind, stateJobs em segundo plano por tipo e estado (available, running, retryable, discarded…).
mof_license_expiry_timestamp_seconds / mof_license_validQuando a licença vence e se ela é válida.
mof_mcp_requests_totalmethod, resultChamadas ao gateway MCP remoto.
mof_metrics_database_up0 quando o MOF não conseguiu ler o banco de dados.
mof_http_requests_totalmethod, route, codeRequisiçõ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_secondsmethod, routeLatência da API (histograma, somável entre processos).
mof_users / mof_accountsstate / providerUsuários (ativos, desativados) e contas de nuvem por provedor.
mof_database_size_bytesdatabaseTamanho 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_goroutinesPool 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.

AlertaQuando
MofDownO MOF parou de responder aos scrapes por 2 minutos.
MofDatabaseUnreachableO MOF não consegue ler o banco de dados.
MofAccountSyncFailingAs faturas ou os recursos de uma conta continuam falhando ao sincronizar (30 minutos).
MofAccountSyncStaleNenhuma sincronização bem-sucedida das faturas ou dos recursos de uma conta em 36 horas.
MofJobsDiscardedJobs em segundo plano que falharam definitivamente na última hora.
MofJobBacklogMais de 50 jobs aguardando por 30 minutos: adicione workers ou procure um travado.
MofHighErrorRateMais de 5% das requisições à API falham com 5xx por 10 minutos.
MofLicenseExpiringA licença vence em até 14 dias.