diff --git a/docs/architecture/vue-densemble.rst b/docs/architecture/vue-densemble.rst index 79e1efb..ee0d8d5 100644 --- a/docs/architecture/vue-densemble.rst +++ b/docs/architecture/vue-densemble.rst @@ -44,6 +44,8 @@ Paquets ``/24`` et ``/32`` * - ``internal/frr`` - génération des commandes FRR, seul point d'appel à ``vtysh`` + * - ``internal/host`` + - connaissance de l'hôte : faits lus au démarrage (``/register``), état mesuré périodiquement en mémoire (``/ping``) * - ``internal/sysctl`` - écriture sous ``/proc/sys``, dans un netns si besoin * - ``internal/netns`` diff --git a/docs/developpement/lab.rst b/docs/developpement/lab.rst index 893a701..ae90aef 100644 --- a/docs/developpement/lab.rst +++ b/docs/developpement/lab.rst @@ -320,6 +320,10 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé - machine d'états — 409 pendant creating, suppression depuis error, sockets QEMU d'une VM en error retirés, dépendances VM → subnet → VPC, suppression d'un subnet en attente de ses VM, arrêt d'une VM juste démarrée par renvoi de system_powerdown, recréation sous le même nom - hv1 - #41, #84, #79 + * - ``13-hote`` + - connaissance de l'hôte — /register (hostname, CPU, RAM, OS, noyau) lu au démarrage, /ping (version, démarrages de l'hôte et de l'agent, uptime, load) mesuré périodiquement, lecture seule, redémarrage de l'agent distingué de celui de l'hôte + - hv1 + - #39 * - ``21-dhcp-two`` - DHCP par le serveur intégré (backend two) — bail, server-id, renouvellement, option 121, un serveur par subnet, démarrages simultanés - hv1 diff --git a/docs/exploitation/configuration.rst b/docs/exploitation/configuration.rst index 9c788ab..030694f 100644 --- a/docs/exploitation/configuration.rst +++ b/docs/exploitation/configuration.rst @@ -80,6 +80,7 @@ Exécution des commandes timeout_subnet_start: 300 timeout_vms_start: 300 poll_interval: 2 + host_state_interval: 10 ``worker.count`` est le nombre de goroutines qui exécutent les commandes ; ``buffer_size`` le nombre de commandes en attente au-delà duquel ``Dispatch`` bloque. @@ -101,6 +102,9 @@ La section ``times`` règle, en secondes, les attentes des commandes asynchrones création d'une VM : attente des subnets de ses interfaces ``running``. ``poll_interval`` pas de toutes ces attentes. +``host_state_interval`` + intervalle entre deux mesures de l'état de l'hôte servi par ``GET /ping`` (voir + :doc:`observabilite`). Chaque valeur doit être strictement positive, et ``next_vms_shutdown`` inférieur à ``timeout_vms_stop`` ; sinon l'agent refuse de démarrer. Les attentes s'enchaînent — une VM, diff --git a/docs/exploitation/observabilite.rst b/docs/exploitation/observabilite.rst index 6ecb44e..7bd8b12 100644 --- a/docs/exploitation/observabilite.rst +++ b/docs/exploitation/observabilite.rst @@ -27,6 +27,31 @@ Les états sont ceux du :doc:`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 -------- diff --git a/release_notes/0.3.0.md b/release_notes/0.3.0.md index 16ba78c..e2a5593 100644 --- a/release_notes/0.3.0.md +++ b/release_notes/0.3.0.md @@ -113,6 +113,16 @@ - Une IP flottante est refusée (409) sur une interface d'un subnet `public_ip`. Le watchdog contrôle les subnets `public_ip` comme les subnets `bridge` +**Connaissance de l'hôte (#39)** + +- `GET /register` : hostname, CPU (fabricant, modèle, sockets, cœurs, threads), RAM totale, OS + et noyau, lus au démarrage de l'agent (503 si la lecture a échoué) +- `GET /ping` : version de l'agent, démarrages de l'hôte et de l'agent (timestamps Unix), + uptime de l'hôte et load, mesurés toutes les `times.host_state_interval` secondes (10 par + défaut) et gardés en mémoire, avec l'heure de la mesure (`collected_at`) +- **L'agent connaît sa version** : injectée au build (tag de la release), affichée dans + `/ping` et dans la ligne `starting agent` du journal + ## Correctifs - **Chaque VRF de VPC porte une route `unreachable default` (#81).** Une recherche qui échouait