ligbox/ligbox-ops-platform
3
0
Fork 0
Code Issues 421 Pull requests Projects Releases Packages Wiki Activity Actions
ligbox-ops-platform/specs/035-ligbox-watchman/contracts/status-snapshot.md
Ligbox Spec Hub c1881f58e6 chore: sync Console SSO, DNS viewer, specs e infra docs pendentes 
Inclui console handoff Desk↔Console (Spec 019), melhorias DNS Viewer (037),
OpenPanel/Nextcloud/VM116 deploy notes, contracts stack e sidebar actualizado.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-25 20:10:17 +00:00

1.4 KiB
Raw Blame History

Contrato — Watchman status snapshot (Spec 035)

Ficheiro: /var/lib/ligbox-watchman/status.json
Actualização: a cada ciclo completo do scheduler (máx. 30 s para tier critical)

Schema JSON

{
  "watchman_version": "1.0.0",
  "generated_at": "2026-06-22T11:30:00+00:00",
  "hostname": "ligbox-ops",
  "summary": {
    "total": 24,
    "ok": 22,
    "degraded": 2,
    "open_incidents": 1
  },
  "last_alert_at": "2026-06-22T11:25:10+00:00",
  "services": [
    {
      "id": "vm122-desk-ui",
      "vm": "122",
      "title": "Desk Frontend",
      "tier": "critical",
      "ok": false,
      "status": "down",
      "consecutive_failures": 3,
      "last_ok_at": "2026-06-21T16:47:00+00:00",
      "last_check_at": "2026-06-22T11:30:00+00:00",
      "detail": "Connection refused",
      "http_status": null,
      "incident_open": true
    }
  ]
}

Campos

Campo Tipo Descrição
ok bool Resultado último probe
status string online | down | check
consecutive_failures int Falhas seguidas (reset em OK)
incident_open bool Alerta DOWN enviado, ainda não RESOLVED
detail string Erro ou HTTP status humanizado

Consumo Desk (Fase 2)

GET /api/v1/watchman/status lê este ficheiro (ou cache 5 s) — sem auth pública; RBAC super_admin, ops_lead, technician, noc.