Installer l'Agent Elark (passerelle de supervision)

1. Ce que fait l’agent, en résumé

L’agent se place sur le LAN du client et fait remonter des informations vers Elark, en lecture seule stricte : il ne pilote jamais aucun équipement et ne relaie jamais de flux vidéo. Ce qu’il peut concrètement superviser dépend de l’environnement sur lequel il tourne :

• Miroir Home Assistant (riche) — si le site a déjà une installation Home Assistant, l’agent en remonte l’inventaire, les états d’entités, les automatisations, les scènes, les helpers, le journal d’activité et les notifications (section 2). Nécessite un Home Assistant existant — l’agent ne fait que le refléter, il n’en installe pas un.
• Agent seul (sans Home Assistant) — sur un site sans HA, l’agent remonte la santé de la machine qui l’héberge et la présence des équipements du réseau local (section 3). Nettement plus limité que le miroir HA, mais fonctionne partout.
• Caméras / ESPHome LAN — annoncés dans certaines présentations du produit, mais non livrés à ce jour : pas de connecteur caméra/NVR ni de connecteur ESPHome LAN dédié (section 4).

2. Miroir Home Assistant — supervision riche, nécessite un HA existant

Quand l’agent tourne comme add-on Home Assistant OS sur une box qui héberge déjà Home Assistant, il en remonte un miroir en lecture seule : inventaire des intégrations/appareils/entités (automatisations, scènes et helpers inclus, ce sont des entités comme les autres), états temps réel, journal d’activité et journal système, santé de HAOS et des add-ons, notifications persistantes. C’est la source de la supervision fine par entité, des automatisations et des scènes — elle n’existe que dans ce cas : un site sans Home Assistant préalable n’y a pas accès, quel que soit le mode d’installation de l’agent.

3. L’agent seul : santé de l’hôte et présence réseau

Sur un site sans Home Assistant (ou pour la partie de l’agent qui ne dépend pas de HA), deux sources de données sont disponibles :

• Santé de l’hôte (syshealth) — CPU, mémoire, disque, température et temps de fonctionnement de la machine qui héberge l’agent (Raspberry Pi, box HAOS…).
• Présence réseau (netpresence) — détecte, par sonde ICMP/TCP, quels équipements du réseau local répondent (« en ligne » / « injoignable »). C’est cette source qui alimente la liste de candidats de la section 5 : elle signale qu’une adresse IP répond, pas ce qu’il y a derrière.

Sans Home Assistant sur le site, c’est tout ce que l’agent peut superviser aujourd’hui : pas d’état d’entité détaillé, pas d’automatisation, pas de scène — cette richesse est exclusivement celle du miroir HA (section 2).

4. Caméras et ESPHome LAN : feuille de route, non livré

La supervision de caméras/NVR et un connecteur dédié aux appareils ESPHome accessibles seulement sur le réseau local (hors du cloud Elark) font partie de la feuille de route, mais n’existent pas encore : dans l’application, l’option « Caméra’» est explicitement marquée Bientôt. Ne comptez pas dessus pour un déploiement en cours.

5. Où l’installer ?

• Sur un site avec Home Assistant OS — installez l’add-on « Elark Edge Agent » depuis votre dépôt d’add-ons. C’est ce mode qui donne accès au miroir HA riche (section 2), en plus de la santé de l’hôte et de la présence réseau.
• Sur un site sans HAOS — installez le service sur une machine Debian/Ubuntu (un Raspberry Pi convient) avec le script fourni. L’agent tourne sous un compte dédié, sans privilège root, et n’ouvre aucun port en écoute. Vous n’avez alors accès qu’à la santé de l’hôte et à la présence réseau (section 3).

6. Enrôler l’agent

1. Dans Elark, ouvrez l’installation concernée, section « Passerelle Edge », puis générez un code d’appairage (valable 15 minutes, usage unique).
2. Sur la box, lancez :
   elark-agent enroll --code XXXX-XXXX
3. L’agent échange le code contre ses identifiants en un seul appel sécurisé, puis ne communique plus qu’en MQTT TLS sortant. Démarrez-le : elark-agent run (ou systemctl enable --now elark-agent).

7. Valider les équipements découverts (présence réseau)

La sonde de présence réseau balaie le LAN et remonte une liste de candidats (adresses qui répondent). Rien n’est supervisé tant que vous n’avez pas validé : dans la section « Passerelle Edge », chaque candidat détecté peut être rattaché (nommé, affecté) ou ignoré. Vous pouvez aussi ajouter manuellement un équipement à configurer (adresse IP fixe, identifiants en lecture seule).

8. Temps de rafraîchissement des données

Chaque famille de données a sa propre cadence de remontée, choisie pour équilibrer réactivité et sobriété (réseau, batterie de la box) : le tableau ci-dessous couvre le cas le plus riche, celui du miroir Home Assistant (section 2).

Les alertes sont évaluées à la réception de chaque donnée : le délai de notification est celui de la ligne correspondante du tableau, plus une à deux secondes.

9. Coupures Internet

Une coupure de quelques minutes, heures ou même plusieurs jours ne bloque pas l’agent : il continue de superviser localement et transmet à la reconnexion. Vous êtes tout de même prévenu rapidement par l’alerte « hors ligne ». L’agent ne se bloque qu’après une absence prolongée de contact (par défaut 30 jours), et repart dès qu’il retrouve le cloud.