Ajout d'une connaissance de l'host #39

Closed
opened 2026-08-16 10:43:51 +00:00 by nicolas.boufideline · 2 comments

l'idee serait d'ajouter un system qui permet de connaitre les infos de l'host, type de cpu, nombre de coeur quantiter de ram

avec un path api

l'idee serait d'ajouter un system qui permet de connaitre les infos de l'host, type de cpu, nombre de coeur quantiter de ram avec un path api
Author
Owner

Plan validé (2026-10-31)

Deux routes en lecture, qui préfigurent les topics du broker (#72) : register (envoyé une fois au démarrage) et ping (envoyé périodiquement).

GET /register : ce qui ne change pas tant que l'hôte tourne

Calculé une fois au démarrage de l'agent, gardé en mémoire.

{ "hostname": "hv1",
  "cpu": { "vendor": "AuthenticAMD", "model": "AMD EPYC 7272 12-Core Processor", "sockets": 1, "cores": 12, "threads": 24 },
  "memory_bytes": 134217728000,
  "os": { "id": "debian", "version_id": "12", "pretty_name": "Debian GNU/Linux 12 (bookworm)" },
  "kernel": "6.1.0-26-amd64" }

Si la lecture échoue au démarrage (pas de /proc hors Linux, fichier illisible), l'agent démarre quand même, journalise l'erreur, et /register répond 503 avec l'erreur.

GET /ping : état courant

Une goroutine mesure au démarrage puis toutes les times.host_state_interval secondes (10 par défaut) et remplace un instantané en mémoire (pas en base : après un redémarrage, la base rendrait la mesure de l'instance précédente). /ping sert le dernier instantané ; 503 tant qu'aucune mesure n'a réussi ; un échec de mesure est journalisé et l'instantané précédent est gardé.

{ "agent_version": "0.3.0", "collected_at": 1793520853,
  "boot_time": 1793499123, "agent_start_time": 1793499190,
  "uptime_seconds": 21730.4, "load": [0.12, 0.30, 0.25] }

Dates en timestamps Unix (secondes) : le consommateur est un logiciel, la conversion ne se fait qu'à l'affichage. boot_time / agent_start_time distinguent un redémarrage de l'hôte d'un redémarrage de l'agent ; boot_time + uptime_seconds donnent l'horloge de l'hôte.

Sources

Fichiers uniquement (parseurs testables hors Linux sur des contenus relevés sous Linux) : /proc/cpuinfo (sockets = physical id distincts, cœurs = couples physical id/core id, threads = entrées processor), MemTotal de /proc/meminfo, /etc/os-release, /proc/sys/kernel/osrelease, btime de /proc/stat, /proc/uptime, /proc/loadavg.

Version de l'agent

var version = "undefined" dans cmd/agent, passée au serveur par sa signature. Release (build.yml) : -ldflags "-X main.version=<tag>". Binaires de test du lab (test/e2e/build.sh) : le commit court, suffixé -dirty si l'arbre a des modifications non commitées.

Découpage

  1. internal/host : lecture et parseurs, tests sur fichiers réels.
  2. API (/register, /ping, 405 sur les autres verbes), job périodique, times.host_state_interval, spec api/agent.yaml.
  3. Version au build (build.yml, build.sh).
  4. e2e 13-hote : /register comparé à nproc, /proc/meminfo, uname -r, os-release ; après redémarrage de l'agent, agent_start_time change et boot_time non ; version = commit du build.
  5. Doc et notes 0.3.0.

Branche feature-39, partie de feature-90.

## Plan validé (2026-10-31) Deux routes en lecture, qui préfigurent les topics du broker (#72) : `register` (envoyé une fois au démarrage) et `ping` (envoyé périodiquement). ### `GET /register` : ce qui ne change pas tant que l'hôte tourne Calculé une fois au démarrage de l'agent, gardé en mémoire. ``` { "hostname": "hv1", "cpu": { "vendor": "AuthenticAMD", "model": "AMD EPYC 7272 12-Core Processor", "sockets": 1, "cores": 12, "threads": 24 }, "memory_bytes": 134217728000, "os": { "id": "debian", "version_id": "12", "pretty_name": "Debian GNU/Linux 12 (bookworm)" }, "kernel": "6.1.0-26-amd64" } ``` Si la lecture échoue au démarrage (pas de `/proc` hors Linux, fichier illisible), l'agent démarre quand même, journalise l'erreur, et `/register` répond 503 avec l'erreur. ### `GET /ping` : état courant Une goroutine mesure au démarrage puis toutes les `times.host_state_interval` secondes (10 par défaut) et remplace un instantané **en mémoire** (pas en base : après un redémarrage, la base rendrait la mesure de l'instance précédente). `/ping` sert le dernier instantané ; 503 tant qu'aucune mesure n'a réussi ; un échec de mesure est journalisé et l'instantané précédent est gardé. ``` { "agent_version": "0.3.0", "collected_at": 1793520853, "boot_time": 1793499123, "agent_start_time": 1793499190, "uptime_seconds": 21730.4, "load": [0.12, 0.30, 0.25] } ``` Dates en timestamps Unix (secondes) : le consommateur est un logiciel, la conversion ne se fait qu'à l'affichage. `boot_time` / `agent_start_time` distinguent un redémarrage de l'hôte d'un redémarrage de l'agent ; `boot_time` + `uptime_seconds` donnent l'horloge de l'hôte. ### Sources Fichiers uniquement (parseurs testables hors Linux sur des contenus relevés sous Linux) : `/proc/cpuinfo` (sockets = `physical id` distincts, cœurs = couples `physical id`/`core id`, threads = entrées `processor`), `MemTotal` de `/proc/meminfo`, `/etc/os-release`, `/proc/sys/kernel/osrelease`, `btime` de `/proc/stat`, `/proc/uptime`, `/proc/loadavg`. ### Version de l'agent `var version = "undefined"` dans `cmd/agent`, passée au serveur par sa signature. Release (`build.yml`) : `-ldflags "-X main.version=<tag>"`. Binaires de test du lab (`test/e2e/build.sh`) : le commit court, suffixé `-dirty` si l'arbre a des modifications non commitées. ### Découpage 1. `internal/host` : lecture et parseurs, tests sur fichiers réels. 2. API (`/register`, `/ping`, 405 sur les autres verbes), job périodique, `times.host_state_interval`, spec `api/agent.yaml`. 3. Version au build (`build.yml`, `build.sh`). 4. e2e `13-hote` : `/register` comparé à `nproc`, `/proc/meminfo`, `uname -r`, `os-release` ; après redémarrage de l'agent, `agent_start_time` change et `boot_time` non ; version = commit du build. 5. Doc et notes 0.3.0. Branche `feature-39`, partie de `feature-90`.
Author
Owner

Campagne 8 (2026-10-31, evpn-3hv, f576f8f)

/register et /ping répondent sur hv1, hv2 et hv3. Exemple hv1 :

{"hostname":"hv1","cpu":{"vendor":"AuthenticAMD","model":"AMD EPYC 7272 12-Core Processor","sockets":1,"cores":4,"threads":4},"memory_bytes":16769540096,"os":{"id":"debian","version_id":"12","pretty_name":"Debian GNU/Linux 12 (bookworm)"},"kernel":"6.1.0-54-amd64"}
{"agent_version":"f576f8f","collected_at":1793464495,"boot_time":1793464261,"agent_start_time":1793464495,"uptime_seconds":233.7,"load":[0.41,0.27,0.12]}

La version injectée par build.sh (commit court) arrive bien jusqu'à /ping.

13-hote : 24/25 dans la suite complète. Le seul échec venait du test : sur les nœuds, awk est mawk, qui affiche MemTotal × 1024 en 1.67695e+10. L'agent rendait la bonne valeur (16769540096). Correctif : printf "%.0f\n", rejoué sur le lab : 25/25. Il sera replié dans le commit du scénario.

Le /proc/cpuinfo réel des hyperviseurs (EPYC 7272 virtualisé, 1 socket, 4 cœurs, 4 threads) est relevé pour les données de test.

## Campagne 8 (2026-10-31, evpn-3hv, `f576f8f`) `/register` et `/ping` répondent sur hv1, hv2 et hv3. Exemple hv1 : ``` {"hostname":"hv1","cpu":{"vendor":"AuthenticAMD","model":"AMD EPYC 7272 12-Core Processor","sockets":1,"cores":4,"threads":4},"memory_bytes":16769540096,"os":{"id":"debian","version_id":"12","pretty_name":"Debian GNU/Linux 12 (bookworm)"},"kernel":"6.1.0-54-amd64"} {"agent_version":"f576f8f","collected_at":1793464495,"boot_time":1793464261,"agent_start_time":1793464495,"uptime_seconds":233.7,"load":[0.41,0.27,0.12]} ``` La version injectée par `build.sh` (commit court) arrive bien jusqu'à `/ping`. `13-hote` : 24/25 dans la suite complète. Le seul échec venait du test : sur les nœuds, `awk` est `mawk`, qui affiche `MemTotal × 1024` en `1.67695e+10`. L'agent rendait la bonne valeur (`16769540096`). Correctif : `printf "%.0f\n"`, rejoué sur le lab : 25/25. Il sera replié dans le commit du scénario. Le `/proc/cpuinfo` réel des hyperviseurs (EPYC 7272 virtualisé, 1 socket, 4 cœurs, 4 threads) est relevé pour les données de test.
Sign in to join this conversation.
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
syonad/two#39
No description provided.