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 — inventaire mémoire & disque (RAM machine, swap, capacité disques, type) #83

New issue
Closed
opened 2026-08-12 10:16:25 +02:00 by nonobis · 1 comment
nonobis commented 2026-08-12 10:16:25 +02:00
Owner
Copy link

🎯 Contexte

Aujourd'hui MemoryUsageBytes = WorkingSet64 du process .NET (pas la RAM de la machine !) et DiskUsagePercent ne regarde que la racine du conteneur. Pour piloter des agents (et savoir si un site peut prendre plus de caméras/GPU), il faut la RAM machine totale/utilisée/swap et les disques réels avec capacité et type.

📚 Référence spec / décision

Décision : deux niveaux de métriques — machine (host) et process/conteneur — remontés distinctement.

  • Mémoire host : /proc/meminfo → MemTotal, MemAvailable, MemFree, SwapTotal, SwapFree, Buffers/Cached (Linux) ; sysctl hw.memsize + vm.swapusage (macOS)
  • Mémoire process : WorkingSet64/PagedMemorySize64 conservés mais étiquetés process
  • Docker : les limites mémoire cgroup (/sys/fs/cgroup/memory.max v2, memory.current) exposées comme ContainerMemoryLimit — le conteneur peut avoir 4 Go alors que le host en a 64
  • Disques : df//proc/mounts → par point de montage : capacité, libre, usage %, filesystem, type SSD/HDD/NVMe (via /sys/block/*/queue/rotation + modèle via /sys/block/*/device/model)

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

SystemMetricsProvider : MemoryUsageBytes = Process.GetCurrentProcess().WorkingSet64 (process), GetTotalMemory lit MemTotal (host), GetDiskUsage = DriveInfo de AppContext.BaseDirectory (racine du conteneur). Agent : MemoryMb (long, mis une fois via UpdateCapabilities) + MemoryUsageBytes live. Pas de swap, pas de disques multiples, pas de type SSD/HDD.

🧩 À faire

  • Refonte SystemMetricsProvider : séparer host vs process (record SystemMetrics enrichi : MemTotalBytes, MemAvailableBytes, SwapTotalBytes, SwapFreeBytes, ProcessMemoryBytes, ContainerMemoryLimitBytes?)
  • Collecteur disques : DiskInventoryProvider — énumérer les montages (/proc/mounts), capacité/libre/type (SSD/HDD via queue/rotation), filesystem
  • Détection limites cgroup mémoire (v2) + exposition ContainerMemoryLimitBytes
  • Entité Agent + migration (AddAgentMemoryDiskInventory) : MemTotalBytes, SwapTotalBytes, liste disques (JSON ou table liée)
  • Heartbeat : transporter l'inventaire (refresh périodique, pas à chaque tick)
  • UI Admin : section mémoire (barre host + process + swap) et disques (par montage) sur la page agent
  • Tests : parsing meminfo, montages, type SSD/HDD

🧪 Critères d'acceptation

  • L'UI distingue RAM machine (ex. 64 Go) vs RAM process du conteneur (ex. 1,2 Go) vs limite cgroup (ex. 4 Go)
  • Swap total/libre remonté
  • Les disques apparaissent par point de montage avec type (SSD/HDD/NVMe) et usage
  • make test vert

📁 Fichiers concernés

src/Heimdall.Agent/Services/SystemMetricsProvider.cs, src/Heimdall.Agent/Services/DiskInventoryProvider.cs (nouveau), src/Heimdall.Domain/Entities/Agent.cs, src/Heimdall.Infrastructure/Data/Migrations/, src/Heimdall.Web/Pages/Agents/AgentDetail.razor, tests/

⚠️ Impact

⚠️ MemoryUsageBytes change de sens (process → machine) : mettre à jour les vues UI/jauge existantes qui l'affichent (Dashboard, AllAgents, MonitoringHub).

📝 Notes

Corrige une ambiguïté existante : la « RAM utilisée » affichée est aujourd'hui celle du process, pas de la machine.

Maquette

Ce ticket est couvert par la maquette du ticket #86 — UI Admin — page inventaire matériel agent (pièce maîtresse du lot télémétrie) : la section « Inventaire » de #86 maquette l'affichage des métriques et specs correspondantes (voir #86, section Maquette).

  • Maquette de référence : #86 (PNG + README attachés)
  • Application Penpot : différée (plugin MCP non connecté)
## 🎯 Contexte Aujourd'hui `MemoryUsageBytes` = **WorkingSet64 du process .NET** (pas la RAM de la machine !) et `DiskUsagePercent` ne regarde que la racine du conteneur. Pour piloter des agents (et savoir si un site peut prendre plus de caméras/GPU), il faut la RAM **machine** totale/utilisée/swap et les disques réels avec capacité et type. ## 📚 Référence spec / décision Décision : deux niveaux de métriques — **machine (host)** et **process/conteneur** — remontés distinctement. - Mémoire host : `/proc/meminfo` → MemTotal, MemAvailable, MemFree, SwapTotal, SwapFree, Buffers/Cached (Linux) ; sysctl `hw.memsize` + `vm.swapusage` (macOS) - Mémoire process : WorkingSet64/PagedMemorySize64 conservés mais étiquetés `process` - **Docker** : les limites mémoire cgroup (`/sys/fs/cgroup/memory.max` v2, `memory.current`) exposées comme `ContainerMemoryLimit` — le conteneur peut avoir 4 Go alors que le host en a 64 - Disques : `df`/`/proc/mounts` → par point de montage : capacité, libre, usage %, filesystem, **type SSD/HDD/NVMe** (via `/sys/block/*/queue/rotation` + modèle via `/sys/block/*/device/model`) ## 🔍 État actuel (vérifié dans le code) `SystemMetricsProvider` : `MemoryUsageBytes = Process.GetCurrentProcess().WorkingSet64` (process), `GetTotalMemory` lit MemTotal (host), `GetDiskUsage` = DriveInfo de `AppContext.BaseDirectory` (racine du conteneur). `Agent` : `MemoryMb` (long, mis une fois via UpdateCapabilities) + MemoryUsageBytes live. Pas de swap, pas de disques multiples, pas de type SSD/HDD. ## 🧩 À faire - [ ] Refonte `SystemMetricsProvider` : séparer host vs process (record `SystemMetrics` enrichi : MemTotalBytes, MemAvailableBytes, SwapTotalBytes, SwapFreeBytes, ProcessMemoryBytes, ContainerMemoryLimitBytes?) - [ ] Collecteur disques : `DiskInventoryProvider` — énumérer les montages (`/proc/mounts`), capacité/libre/type (SSD/HDD via `queue/rotation`), filesystem - [ ] Détection limites cgroup mémoire (v2) + exposition `ContainerMemoryLimitBytes` - [ ] Entité `Agent` + migration (`AddAgentMemoryDiskInventory`) : MemTotalBytes, SwapTotalBytes, liste disques (JSON ou table liée) - [ ] Heartbeat : transporter l'inventaire (refresh périodique, pas à chaque tick) - [ ] UI Admin : section mémoire (barre host + process + swap) et disques (par montage) sur la page agent - [ ] Tests : parsing meminfo, montages, type SSD/HDD ## 🧪 Critères d'acceptation - [ ] L'UI distingue RAM machine (ex. 64 Go) vs RAM process du conteneur (ex. 1,2 Go) vs limite cgroup (ex. 4 Go) - [ ] Swap total/libre remonté - [ ] Les disques apparaissent par point de montage avec type (SSD/HDD/NVMe) et usage - [ ] `make test` vert ## 📁 Fichiers concernés src/Heimdall.Agent/Services/SystemMetricsProvider.cs, src/Heimdall.Agent/Services/DiskInventoryProvider.cs (nouveau), src/Heimdall.Domain/Entities/Agent.cs, src/Heimdall.Infrastructure/Data/Migrations/, src/Heimdall.Web/Pages/Agents/AgentDetail.razor, tests/ ## ⚠️ Impact ⚠️ `MemoryUsageBytes` change de sens (process → machine) : mettre à jour les vues UI/jauge existantes qui l'affichent (Dashboard, AllAgents, MonitoringHub). ## 📝 Notes Corrige une ambiguïté existante : la « RAM utilisée » affichée est aujourd'hui celle du process, pas de la machine. --- ## Maquette Ce ticket est couvert par la maquette du ticket **#86 — UI Admin — page inventaire matériel agent** (pièce maîtresse du lot télémétrie) : la section « Inventaire » de #86 maquette l'affichage des métriques et specs correspondantes (voir #86, section Maquette). - Maquette de référence : #86 (PNG + README attachés) - Application Penpot : différée (plugin MCP non connecté)
nonobis commented 2026-08-14 11:09:14 +02:00
Author
Owner
Copy link

Maquette : couverte par le ticket #86 (inventaire matériel agent) — section ## Maquette ajoutée au corps.

Maquette : couverte par le ticket #86 (inventaire matériel agent) — section ## Maquette ajoutée au corps.
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#83
No description provided.