Sondes de santé synthétiques OpenClaw Gateway : boucles curl, journaux JSONL et supervision compatible launchd sur Mac cloud loué

Les incidents de production commencent rarement par des traces spectaculaires — ils commencent quand personne ne remarque que la passerelle ne répond plus jusqu’à ce que les files de webhooks inondent Slack. Les sondes synthétiques — des appels curl serrés vers la boucle locale, des journaux structurés en append-only et des LaunchAgents qui respectent ThrottleInterval — donnent aux opérateurs de Hong Kong, Tokyo, Séoul, Singapour et des États-Unis une pulsation honnête sans confier d’identifiants à un SaaS externe. Cet article de mai 2026 relie la cadence des sondes aux guides amont sur la liaison localhost, explique les budgets d’échec, présente neuf étapes de déploiement et trace les escalades lorsque des sondes consécutives échouent.

Lisez d’abord le durcissement de la liaison localhost, le dépannage du démon passerelle, les contrôles de santé de bascule production, et le hub collection OpenClaw. Ancres : aide, tarifs, VNC.

Pourquoi les sondes synthétiques battent « quelqu’un remarquera »

openclaw doctor capte la dérive de configuration mais coûte des secondes de CPU ; des curls légers prouvent à bon marché que l’écouteur HTTP accepte encore des sockets — crucial quand le TLS se termine sur localhost via des tunnels SSH.

Matrice du contrat d’endpoint de santé

Style d’endpoint	Signal attendu	Faux positifs	Atténuation
HTTP 200 corps vide	Écouteur vivant	Processus bloqué après accept()	Coupler avec des contrôles RSS processus
Charge JSON d’état	Version + build	Échecs d’analyse supplémentaires	Utiliser les codes de sortie jq
Sonde upgrade WebSocket	Santé pile complète	Bruyant à implémenter	Réserver aux passerelles palier 1

Garde-fous curl que tout script de sonde doit inclure

• --fail --silent --show-error avec budgets explicites de connexion + max-time.
• Boucle locale uniquement (127.0.0.1) sauf maillage TLS documenté.
• stderr structuré avec préfixes horodatés ISO + ID de location.

Modèle LaunchAgent avec throttle pour assistants de sonde

launchd relancera volontiers des sondes qui plantent sans ThrottleInterval et des codes de sortie sains — reproduisez la discipline anti boucle de crash des articles de récupération passerelle.

Déploiement en neuf étapes pour l’adoption des sondes

1. Établir la base JSON de doctor avant toute modification.
2. Fixer le port d’écoute (souvent 18789) dans la doc pare-feu avec SSH.
3. Rédiger l’enveloppe curl versionnée à côté de l’infra-as-code.
4. Essai à sec manuellement depuis une session SSH.
5. Installer le LaunchAgent sous le bon utilisateur macOS.
6. Vérifier la croissance JSONL + la politique de rotation.
7. Raccorder l’acheminement d’alertes (PagerDuty/webhook) après succès à sec.
8. Jour J : faites échouer la passerelle volontairement — vérifiez que les alertes partent.
9. Rétro des seuils chaque trimestre.

Journaux append JSONL et volumétrie SIEM

Une sonde par minute produit ~525k lignes/an — négligeable face aux traces webhook mais suffisant pour mériter une rotation gzip alignée sur le guide rotation JSONL.

Liens croisés vers supervision et résilience

Liez les sondes aux exercices d’arrêt gracieux pour que les fenêtres de maintenance ne déclenchent pas d’alertes doubles, et mappez les retries avec le guide backoff fournisseur lorsque les API LLM amont clignotent.

FAQ

Les sondes peuvent-elles s’authentifier ? Préférez la boucle locale sans auth ; si nécessaire, stockez les jetons bearer dans l’environnement launchd — jamais en dur dans le dépôt.

Quel budget RTT pour des observateurs Tokyo lisant des logs US ? Mesurez empiriquement — l’aller-retour transpacifique dépasse souvent 120 ms ; les pipelines d’alerte doivent tolérer le jitter.

Où étendre la flotte ? Commencez par les tarifs avant de saturer les hôtes de supervision.

Pourquoi le Mac mini loué reste l’ancre pratique des sondes

L’efficacité à l’inactivité d’Apple Silicon garde les curls d’arrière-plan peu coûteux ; répartir les passerelles sur HK/JP/KR/SG/US isole les pannes régionales sans doubler la cardinalité des sondes sur un mini surchargé.