f-39: doc: connaissance de l'hôte, notes 0.3.0 #39

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-31 15:19:59 +01:00
commit 50bc2497ec
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
5 changed files with 45 additions and 0 deletions

View file

@ -27,6 +27,31 @@ Les états sont ceux du :doc:`cycle de vie </concepts/cycle-de-vie>`. Une valeur
durable sur ``error`` est l'alerte la plus utile à poser ; une valeur durable sur ``creating``
ou ``deleting`` signale une opération qui n'aboutit pas.
Connaissance de l'hôte
----------------------
Deux routes de l'API de l'agent, en lecture seule (voir :doc:`api-agent/reference`) :
``GET /register``
ce qui ne change pas tant que l'hôte tourne : hostname, CPU (fabricant, modèle, sockets,
cœurs, threads), RAM totale, OS (``/etc/os-release``) et noyau. Lu une fois au démarrage de
l'agent ; si la lecture échoue, l'agent démarre quand même, journalise ``host facts
unavailable`` et la route répond 503 avec l'erreur.
``GET /ping``
l'état courant : version de l'agent, démarrage de l'hôte (``boot_time``) et de l'agent
(``agent_start_time``), uptime de l'hôte et load sur 1, 5 et 15 minutes. Mesuré au démarrage
puis toutes les ``times.host_state_interval`` secondes (10 par défaut), gardé en mémoire ;
``collected_at`` donne l'heure de la mesure. 503 tant qu'aucune mesure n'a réussi ; une mesure
en échec est journalisée (``host state collection failed``) et la précédente reste servie.
Les dates sont des timestamps Unix en secondes. Un ``boot_time`` qui change signale un
redémarrage de l'hôte, un ``agent_start_time`` seul un redémarrage de l'agent ;
``boot_time`` + ``uptime_seconds`` donne l'horloge de l'hôte au moment de la mesure.
La version de l'agent est injectée au build : le tag pour une release, le commit court
(suffixé ``-dirty`` si l'arbre avait des modifications) pour les binaires de test du lab,
``undefined`` sinon. Elle figure aussi dans la ligne ``starting agent`` du journal.
Watchdog
--------