nonobis/Heimdall
Watch
1
0
Fork
You've already forked Heimdall
 0
Code Issues 24 Pull requests Projects Releases Packages Activity Actions 1

FEAT: Télémétrie agent — OS, conteneur Docker & réseau (host vs container, IPs, températures) #85

New issue
Closed
opened 2026-08-12 10:16:26 +02:00 by nonobis · 0 comments
nonobis commented 2026-08-12 10:16:26 +02:00
Owner
Copy link

🎯 Contexte

Compléter la photo machine : OS/kernel, hostname réel, infos conteneur (ID, image, limites cgroup), interfaces réseau/IP, température système. Objectif : en cas d'incident sur un site distant, le central doit pouvoir dire « cet agent tourne dans tel conteneur, sur tel OS, avec telle IP, et le host a tel uptime » — sans SSH.

📚 Référence spec / décision

Décision : collecte host + conteneur, remontée distincte.

  • OS : /etc/os-release (PRETTY_NAME), uname -r (kernel), uname -m (arch) — attention : dans le conteneur, /etc/os-release est celui du conteneur (Debian slim) ; le host est visible si /etc/hostname monté ou via lscpu/dmi
  • Docker : HOSTNAME env, /proc/self/cgroup (ID conteneur), /.dockerenv (indicateur), limites cgroup CPU/mémoire
  • Matériel host : /sys/class/dmi/id/product_name, board_vendor, board_name (si monté/lisible) — nom du PC serveur
  • Réseau : interfaces (/proc/net/dev), IP (ip/ifconfig si dispo, sinon parsing), MAC, débit ?
  • Température : /sys/class/thermal/thermal_zone*/temp (CPU/board), sensors si dispo
  • Uptime machine : /proc/uptime (≠ uptime du process actuel)

🔍 État actuel (vérifié dans le code)

Agent : Hostname (déjà envoyé au register), Version (agent), PublicIp (via ipify/ifconfig.me au register). SystemMetricsProvider calcule UptimeSeconds = uptime du process .NET (Process.StartTime), pas de la machine. Aucune info OS/kernel/conteneur/réseau/température.

🧩 À faire

  • Collecteur HostInfoProvider : OS (os-release), kernel (uname), arch, uptime machine (/proc/uptime), hostname
  • Collecteur ContainerInfoProvider : détection Docker (/.dockerenv, cgroup), ID conteneur, image (env ou /proc/1/cgroup), limites cgroup CPU/mémoire
  • Collecteur réseau : interfaces/IP (IPv4+IPv6 par interface), MAC, type (eth/wlan)
  • Température : zones thermiques sysfs + CPU package
  • Entité Agent + migration (AddAgentHostInventory) : OsName, KernelVersion, Arch, ContainerId, ContainerImage, ContainerCpuLimit, ContainerMemoryLimit, Interfaces (JSON), UptimeMachineSeconds
  • Heartbeat/register : transporter l'inventaire (register + refresh)
  • UI Admin : section « Machine » (OS, kernel, conteneur, IPs, temp, uptime machine vs process)
  • Tests : parsing os-release, cgroup, /proc/uptime

🧪 Critères d'acceptation

  • Un agent Docker déclare : image (ex. eltruncho/heimdall-agent:latest), conteneur ID, limites CPU/mémoire, OS conteneur + (si possible) nom de la machine hôte
  • Uptime machine (host) distinct de l'uptime du process agent
  • IPs par interface visibles dans l'UI
  • Température CPU remontée quand le sysfs est lisible
  • make test vert

📁 Fichiers concernés

src/Heimdall.Agent/Services/HostInfoProvider.cs, src/Heimdall.Agent/Services/ContainerInfoProvider.cs, src/Heimdall.Agent/Services/NetworkInfoProvider.cs (nouveaux), src/Heimdall.Domain/Entities/Agent.cs, src/Heimdall.Infrastructure/Data/Migrations/, src/Heimdall.Web/Pages/Agents/AgentDetail.razor, tests/

⚠️ Impact

Le conteneur voit l'OS du conteneur, pas du host : c'est une limite Docker normale — à documenter dans l'UI (ne pas faire croire que c'est l'OS du host).

📝 Notes

L'uptime machine est utile pour détecter un reboot du site (≠ redémarrage du conteneur agent).

## 🎯 Contexte Compléter la photo machine : OS/kernel, hostname réel, infos **conteneur** (ID, image, limites cgroup), interfaces réseau/IP, température système. Objectif : en cas d'incident sur un site distant, le central doit pouvoir dire « cet agent tourne dans tel conteneur, sur tel OS, avec telle IP, et le host a tel uptime » — sans SSH. ## 📚 Référence spec / décision Décision : collecte host + conteneur, remontée distincte. - OS : `/etc/os-release` (PRETTY_NAME), `uname -r` (kernel), `uname -m` (arch) — attention : dans le conteneur, /etc/os-release est celui du **conteneur** (Debian slim) ; le host est visible si `/etc/hostname` monté ou via `lscpu`/dmi - **Docker** : `HOSTNAME` env, `/proc/self/cgroup` (ID conteneur), `/.dockerenv` (indicateur), limites cgroup CPU/mémoire - Matériel host : `/sys/class/dmi/id/product_name`, `board_vendor`, `board_name` (si monté/lisible) — nom du PC serveur - Réseau : interfaces (`/proc/net/dev`), IP (ip/ifconfig si dispo, sinon parsing), MAC, débit ? - Température : `/sys/class/thermal/thermal_zone*/temp` (CPU/board), `sensors` si dispo - Uptime **machine** : `/proc/uptime` (≠ uptime du process actuel) ## 🔍 État actuel (vérifié dans le code) `Agent` : `Hostname` (déjà envoyé au register), `Version` (agent), `PublicIp` (via ipify/ifconfig.me au register). `SystemMetricsProvider` calcule `UptimeSeconds` = **uptime du process .NET** (Process.StartTime), pas de la machine. Aucune info OS/kernel/conteneur/réseau/température. ## 🧩 À faire - [ ] Collecteur `HostInfoProvider` : OS (os-release), kernel (uname), arch, uptime machine (/proc/uptime), hostname - [ ] Collecteur `ContainerInfoProvider` : détection Docker (/.dockerenv, cgroup), ID conteneur, image (env ou /proc/1/cgroup), limites cgroup CPU/mémoire - [ ] Collecteur réseau : interfaces/IP (IPv4+IPv6 par interface), MAC, type (eth/wlan) - [ ] Température : zones thermiques sysfs + CPU package - [ ] Entité `Agent` + migration (`AddAgentHostInventory`) : OsName, KernelVersion, Arch, ContainerId, ContainerImage, ContainerCpuLimit, ContainerMemoryLimit, Interfaces (JSON), UptimeMachineSeconds - [ ] Heartbeat/register : transporter l'inventaire (register + refresh) - [ ] UI Admin : section « Machine » (OS, kernel, conteneur, IPs, temp, uptime machine vs process) - [ ] Tests : parsing os-release, cgroup, /proc/uptime ## 🧪 Critères d'acceptation - [ ] Un agent Docker déclare : image (ex. eltruncho/heimdall-agent:latest), conteneur ID, limites CPU/mémoire, OS conteneur + (si possible) nom de la machine hôte - [ ] Uptime machine (host) distinct de l'uptime du process agent - [ ] IPs par interface visibles dans l'UI - [ ] Température CPU remontée quand le sysfs est lisible - [ ] `make test` vert ## 📁 Fichiers concernés src/Heimdall.Agent/Services/HostInfoProvider.cs, src/Heimdall.Agent/Services/ContainerInfoProvider.cs, src/Heimdall.Agent/Services/NetworkInfoProvider.cs (nouveaux), src/Heimdall.Domain/Entities/Agent.cs, src/Heimdall.Infrastructure/Data/Migrations/, src/Heimdall.Web/Pages/Agents/AgentDetail.razor, tests/ ## ⚠️ Impact Le conteneur voit l'OS du conteneur, pas du host : c'est une limite Docker normale — à documenter dans l'UI (ne pas faire croire que c'est l'OS du host). ## 📝 Notes L'uptime machine est utile pour détecter un reboot du site (≠ redémarrage du conteneur agent).
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
feat/migrate-ci-woodpecker
feat/implement-all-5-tickets-complètement
fix/pending-model-changes-warning
feat/131-user-camera-access-entity
feat/11-persons-ui
feat/mobile-feature
feat/134-camera-access-panel-ui
feat/89-confirm-user-email
fix/27-e2e-tests
feat/133-user-camera-access-api
feat/141-camera-access-tests
fix/mobile-ci
feat/110-camera-discovery-ui
feat/136-filter-sites-by-user-access
feat/142-i18n-localization
feat/14-opentelemetry-metrics
feat/59-toggle-camera-status
feat/75-agent-remote-mode
feat/76-agent-gpu-worker
feat/86-agent-inventory-ui
fix/25-readme-update
fix/47-auth-redirect
fix/77-docker-compose-gpu
feat/11-persons-ui-new
feat/88-edit-user-email
fix/ci-infra-heimdall
feat/feat-application-mobile-android-kotlin-jetpack-com
feat/feat-release-notes-automatiques-forgejo-changelog
feat/feat-service-icameraaccessservice-r-solution-des-a
feat/feat-backup-automatis-postgresql-alarik-avec-test-
feat/feat-filtrage-cam-ras-adapter-getcamerasbysite-aux
feat/feat-suppression-de-site-en-cascade-agents-et-cam-
feature/auto-update-docker
feature/auto-update-native
feature/audit-full-coverage
feat/agent-inventory-ui
feat/integration-settings-ui
feat/ntfy-config-complete
feat/agent-gpu-consumer
fix/ci-refonte-politique-143
No results found.
Labels
Clear labels   
bug
Comportement incorrect ou risque fonctionnel

  
chore
Maintenance, dépendances, CI, outillage

  
design
Ticket avec composante UI — maquette the-designer requise/intégrée

  
dx:ci

   
dx:database

   
dx:dotnet

   
dx:infra

   
dx:security

   
dx:tests

   
dx:ui

   
etape-1
Étape 1 — MVP Multi-Site (phases 1-12)

  
etape-2
Étape 2 — Caméras + Temps réel (phases 13-14)

  
etape-3
Étape 3 — Vidéo + IA (phases 15-16)

  
etape-4
Étape 4 — Événements + Notifications (phases 17-19)

  
etape-5
Étape 5 — UI Blazor complète (phases 20-23)

  
etape-6
Étape 6 — Production Hardening (phase 24)

  
etape-7
Étape 7 — Mobile (phase 25)

  
feature
Nouvelle fonctionnalité / implémentation spec manquante

  
priority-high
Priorité haute — bloque le cœur métier

  
priority-low
Priorité faible / cosmétique

  
priority-medium
Priorité moyenne

  
security
Vulnérabilités CVE, scans Trivy/OWASP, security hardening

  
spec
Référence à MASTER_SPECIFICATION.md

  
tech-debt
Dette technique, obsolescence, drift documentation

No labels
bug
chore
design
dx:ci
dx:database
dx:dotnet
dx:infra
dx:security
dx:tests
dx:ui
etape-1
etape-2
etape-3
etape-4
etape-5
etape-6
etape-7
feature
priority-high
priority-low
priority-medium
security
spec
tech-debt
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
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
nonobis/Heimdall#85
No description provided.