cdn.pizzaDocumentation

Monitoring et statut

Status-agents

Un status-agent exécute des checks locaux et publie résultats et heartbeats.

#Vue d’ensemble

Un status-agent exécute des checks locaux et publie résultats et heartbeats.

#Enrôlement et compatibilité

Une clé cps_… à durée et usages limités permet status-agent:enroll. La CLI échange cette clé contre un identifiant agent et un token stocké localement en mode 0600; status-agent:status masque le secret.

L’agent envoie un heartbeat, télécharge sa configuration puis soumet les résultats. La capacité monitor_generation_v1 et configuration_version évitent qu’un résultat d’ancienne configuration modifie le check actuel.

#Installer un agent

  1. Créez la clé avec status-agent:key.

  2. Enrôlez la machine avec status-agent:enroll --token cps_….

  3. Testez une passe avec status-agent:run --once.

  4. Configurez le service en boucle et vérifiez heartbeat, version et checks assignés.

#Cycle d’état

ÉtatSignification
activeCredential accepté; configuration et résultats autorisés.
disabledAgent conservé mais exécution refusée jusqu’à réactivation.
revokedCredential définitivement révoqué; enrôlez à nouveau.

#Exemple vérifiable

bash
cdn-pizza status-agent:key --status-page STATUS_PAGE_ID -n branch-agent
cdn-pizza status-agent:run --once
Documentation clientRéférence générée depuis les interfaces publiées