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:
parent
f18e23c425
commit
50bc2497ec
5 changed files with 45 additions and 0 deletions
|
|
@ -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``
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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,
|
||||
|
|
|
|||
|
|
@ -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
|
||||
--------
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue