2026 : métriques Prometheus, tableaux Grafana et alertes launchd pour la passerelle OpenClaw sur Mac cloud MacLogin
Les équipes qui exploitent des passerelles Apple Silicon à Hong Kong, Tokyo, Séoul, Singapour ou aux États-Unis maîtrisent déjà curl sur /health/ready, mais l'incident arrive souvent sous la forme « tout allait bien jusqu'à la facture ». Ce guide (mai 2026) montre comment activer l'exposition texte diagnostics Prometheus, la scraper avec un collecteur compatible, brancher Grafana avec des panneaux SLO, appliquer des fenêtres FOR de cinq minutes et respecter ThrottleInterval pour éviter que les sidecars ne disputent le SSD. Deux tableaux aux structures différentes, neuf étapes chiffrées et des seuils prêts à coller dans Prometheus ou Grafana Alerting complètent la livraison.
Lectures préalables : boucles curl, rotation JSONL, doctor, hub OpenClaw. Liens publics : aide, tarifs, VNC.
Pourquoi les compteurs Prometheus révèlent des angles morts invisibles pour curl
Les sondes répondent « le socket accepte-t-il ? » tandis que les compteurs répondent « la fréquence d'échec des outils augmente-t-elle sur 30 minutes ? ». Lorsqu'un fournisseur LLM commence à limiter le débit, HTTP 200 peut persister alors que la profondeur de file d'attente grimpe—seules les métriques de tendance sonnent l'alarme en avance. Les plugins diagnostics-prometheus documentés en amont exposent du texte exploitable par n'importe quel scraper compatible, sans expédier les corps de webhook vers un SaaS tiers.
- Dérive de latence : histogrammes ou approximations quantiles pour détecter une p95 qui se dégrade.
- Économie de jetons : les compteurs USD aident la finance à rapprocher chaque locataire avec une classe SSD courante de 512 Go sur Mac mini M4 loués.
- Santé des canaux : alignez la cadence de scrape sur la détection de staleness souvent évoquée à la maille de 5 minutes ; un scrape toutes les 12 secondes apporte peu si la rétention Grafana n'est que de 15 jours.
Matrice des sources de signal
| Source | Idéal pour | Risque cardinalité | À éviter quand |
|---|---|---|---|
/api/diagnostics/prometheus | SLO, budgets d'erreur | Élevé si labels par locataire explosent | HTTP clair non authentifié |
/health/ready / live | Gilles d'orchestration | Faible | Diagnostics profonds des dépendances |
openclaw health --json | Pont humain incident | Aucun | Polling continu sub-minute |
openclaw doctor | Dérive de configuration | Aucun | Détection de saturation temps réel |
Chemin de scrape sécurisé
Suivez le durcissement loopback : Prometheus ou vmagent doit joindre 127.0.0.1 dans le même contexte utilisateur que la passerelle ou passer par un tunnel SSH. Pour un observateur à Singapour scrutant un mini à Tokyo, prévoyez ~180 ms de marge RTT dans la clause FOR.
Neuf étapes opérables
- Inventorier les sondes du runbook du 7 mai (souvent 90 s).
- Activer diagnostics Prometheus ; vérifier les lignes
# HELP. - Fumée
curl --failavec le même en-tête que Grafana. - Étiqueter
region="sg"sans secrets webhook. - Job Prometheus par défaut 30 s sauf CPU oisif > 25 %.
- Importer le JSON Grafana ; UID de datasource figés par région HK/JP/KR/SG/US.
- Alertes avec 5 m FOR.
- Game day : casser les identifiants pour valider l'ordre d'alerte.
- Revue mensuelle : séries inutilisées supprimées, WAL < 4 Go sur petits disques.
Panneaux Grafana et seuils réutilisables
| Objectif | Esquisse PromQL | Seuil | Raison | Propriétaire |
|---|---|---|---|---|
| Taux d'échec | rate(openclaw_run_completed_total{status="error"}[5m]) | > 0,05/s pendant 10 m | Cascades d'outils | Plateforme |
| Latence modèle | histogram_quantile(0.95, sum(rate(openclaw_model_call_duration_seconds_bucket[5m])) by (le)) | > 6 s / 5 m | Throttling avant SLA | Équipe IA |
| Erreurs d'outils | increase(openclaw_tool_execution_total{status="error"}[15m]) | > 12 | Capacité triage humain | DevOps |
| Garde-fou coût | increase(openclaw_model_cost_usd_total[1h]) | > 48 USD/h | Paging finance | FinOps |
launchd et budget disque
Réutilisez ThrottleInterval des articles de récupération pour éviter 12 redémarrages/minute après échec WAL. Croisez avec JSONL SIEM : 780 Ko par scrape × 40 cibles ≈ 2,7 Go/jour—ajustez rétention ou remote_write par paquets de 60 s avant que la journalisation unifiée ne sature.
Liens croisés
Alignez les annotations Grafana sur blue-green et séparez reprises externes via clés d'idempotence.
FAQ
Sans Grafana ? VictoriaMetrics seul suffit souvent ; Grafana accélère l'alignement multi-métiers.
remote_write hors Mac ? Vérifiez l'egress ; le batch 60 s divise souvent la bande passante par deux.
Remplace-t-il doctor ? Non—les fautes de label LaunchAgent restent du ressort de doctor.
Pourquoi le Mac mini M4 reste pertinent pour le plan de métriques
La courbe de puissance Apple Silicon rend les sidecars de scrape toujours actifs peu coûteux face aux VM x86 bursty ; macOS natif héberge CLI openclaw, trousseau et kiosque Grafana sans virtualisation imbriquée. L'empreinte HK/JP/KR/SG/US de MacLogin permet de sharder les passerelles tout en centralisant les tableaux—à condition d'étiqueter honnêtement les séries pour distinguer jitter réseau à Singapour de saturation CPU à Séoul.
Hébergez une passerelle OpenClaw observable sur Apple Silicon
Mac mini prêts SSH/VNC—métriques et sondes harmonisées par région.
