2026 — OpenClaw Gateway, métriques Prometheus et tableaux Grafana : activer le scrape /metrics, seuils d’alerte et tri des faux positifs sur Mac physique distant 7j/7 (extraits scrape, requêtes de panneaux + FAQ)

2. Points de friction

1. Contrainte : adresse d’écoute vs. emplacement de Prometheus. Si la passerelle n’écoute que sur 127.0.0.1 alors que Prometheus est dans un conteneur ou sur un autre hôte d’observabilité, les scrapes échouent — up=0 — alors que le curl local sur le Mac fonctionne.
2. Coût caché : labels à forte cardinalité et scrape_interval agressif. Mettre des chemins bruts ou des fragments de clé API dans les labels fait exploser la cardinalité TSDB ; des scrapes à 1 s sur Wi‑Fi ou tunnel amplifient le jitter en « graphiques en cheveux » Grafana.
3. Stabilité et faux positifs : économie d’énergie macOS et fenêtres de déploiement. Veille écran, veille disque ou rechargement à chaud peuvent faire grimper le p95 brièvement ; des alertes avec for: 0s réveillent l’astreinte pour du bruit.

3. Matrice scrape et alertes

Avant la mise en production, alignez-vous sur « qui scrape depuis quel espace réseau » et si les alertes doivent respecter les heures ouvrées.

4. Runbook en sept étapes (Mac physique distant)

1. Confirmer le point de terminaison et l’écoute. Activez les métriques dans la config passerelle ; vérifiez metrics_path (souvent /metrics) et l’IP d’écoute. Pour des scrapes distants, évitez 127.0.0.1 seul sauf si le scraper partage ce namespace.
2. Test fumée local. curl -sS http://127.0.0.1:<port>/metrics | head -n 40 et vérifiez les lignes HELP/TYPE pour HTTP et process.
3. Choisir l’emplacement du scraper. PoC mono-nœud : Prometheus colocalisé. Nombreux nœuds : remote-write vmagent ou Prometheus central avec listes de pare-feu.
4. Rédiger scrape_configs (ci-dessous). Utilisez scrape_interval: 15s–30s, un scrape_timeout raisonnable, un relabeling instance stable.
5. Brancher Grafana. Ajoutez la datasource Prometheus ; panneaux pour RPS global, p95, ratio 5xx, up et durée de scrape.
6. Définir alertes et routes. Utilisez des for différents pour les ratios d’erreur vs. up brut ; silences Alertmanager ou drapeaux de maintenance CI pendant les déploiements.
7. Aligner macOS pour le 7j/7. Privilégiez l’Ethernet filaire, désactivez la veille disque, vérifiez fuseau et NTP. Séparez les problèmes de droits et de secrets des métriques : si le scrape est sain mais l’app renvoie 500, lisez les journaux applicatifs avant d’incriminer Prometheus. Pour le TCO nœuds distants multi-régions, voir aussi équipes Apple transfrontalières — Mac mini ou nœuds distants multi-régions ? TCO 3 ans (tableau).

5. Extraits scrape, PromQL et alertes

5.1 Extrait Prometheus scrape_configs

Remplacez targets et le port par l’adresse d’écoute de votre passerelle. Derrière un reverse proxy, laissez passer /metrics et désactivez le cache pour ce chemin.

scrape_configs:
  - job_name: openclaw-gateway
    scrape_interval: 15s
    scrape_timeout: 10s
    metrics_path: /metrics
    static_configs:
      - targets:
          - '127.0.0.1:18789'
        labels:
          env: prod
          role: gateway
    # relabel_configs:
    #   - source_labels: [__address__]
    #     target_label: instance

5.2 Requêtes de panneaux Grafana (adaptez les noms de métriques)

• Requêtes par seconde (RPS) : sum(rate(http_requests_total{job="openclaw-gateway"}[5m]))
• Latence p95 (histogramme) : histogram_quantile(0.95, sum(rate(http_request_duration_seconds_bucket{job="openclaw-gateway"}[5m])) by (le))
• Ratio 5xx (exemple) : sum(rate(http_requests_total{job="openclaw-gateway",status=~"5.."}[5m])) / sum(rate(http_requests_total{job="openclaw-gateway"}[5m]))
• Santé du scrape : up{job="openclaw-gateway"} et scrape_duration_seconds{job="openclaw-gateway"}

5.3 Règles d’alerte (Prometheus rule_files)

groups:
  - name: openclaw_gateway
    rules:
      - alert: GatewayScrapeDown
        expr: up{job="openclaw-gateway"} == 0
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "Point de terminaison métriques OpenClaw injoignable"
      - alert: GatewayHigh5xxRatio
        expr: sum(rate(http_requests_total{job="openclaw-gateway",status=~"5.."}[5m])) / sum(rate(http_requests_total{job="openclaw-gateway"}[5m])) > 0.05
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "Ratio 5xx > 5 % (adapter les labels au schéma réel)"

Si vos métriques utilisent code ou un label outcome au lieu de status, réécrivez les sélecteurs — validez des vecteurs non vides dans Grafana Explore avant de promouvoir en alertes.

6. Tri typique des faux positifs

7. Seuils prêts à citer

• scrape_interval : 15 s en production (ne descendez pas plus bas que la latence de queue de la passerelle sans raison) ; 30 s sur des liaisons intercontinentales.
• scrape_timeout : gardez ≤ ~2/3 de scrape_interval ; commencez à 10 s sur chemins tunnelisés.
• for sur les alertes : règles de disponibilité à partir de 2 min ; ratios à partir de 5 min, puis resserrez après alignement avec les taux de burn SLO.

8. FAQ

9. Synthèse et choix de nœud

Une fois les métriques HTTP et process de la passerelle OpenClaw dans Prometheus et Grafana, les incidents sur nœuds physiques 7j/7 passent du « SSH et intuition » à la vérification conjointe de up, des taux d’erreur et du p95. Les thèmes récurrents sont l’alignement adresse d’écoute / chemin réseau du scraper, l’usage de for sur les alertes et l’exclusion du bruit lié à l’énergie macOS et aux déploiements du périmètre SLO.

Ce duo « passerelle + pile d’observabilité » se prête bien à macOS : launchd, journaux et outillage Unix partagent une même stack ; Apple Silicon consomme très peu au ralenti — adapté aux passerelles toujours actives. Face à de petits boîtiers x86 au prix comparable, vous gagnez en général en stabilité et efficacité énergétique, tandis que Gatekeeper, SIP et FileVault durcissent identifiants et points de terminaison tunnel — ce qui compte pour l’exploitation distante.

Si vous voulez déployer les extraits scrape et tableaux de cet article sur du matériel silencieux, sobre et taillé pour le 7j/7, le Mac mini M4 reste l’un des meilleurs rapports qualité-prix en 2026 — louez un Mac physique via ZoneMac et intégrez les métriques passerelle à votre ligne de base production en une passe.