Introduction

L'agent Alemca est une solution flexible et modulaire, destinée à faciliter la communication entre différents services Alemca et vos équipements. Fonctionnant sur les systèmes d'exploitation Linux, Windows et MacOS, il est écrit en Golang.

Vue d’ensemble

Caractéristique	Détails
Systèmes	Linux, Windows, macOS
Mode de déploiement	Binaire statique ou conteneur docker (image officielle : registry.alemca.com/public/agent-alemca:latest)
Canal de contrôle	Cannal AMQPs vers le Backend Alemca
Extensibilité	Plugins + Modules (IOT) + Scripts Lua dynamiques + Addons (gRPC)

Pourquoi Go ?

• Concurrence native (goroutines).
• Empaquetage cross-platform sans dépendances partagées.
• Empreinte mémoire inférieure à celle d’un runtime Java / .NET comparable.

Fonctionnalités clés

Fonction	Ce que cela vous offre
Sécurité de bout en bout	Chiffrement AES-256/GCM + authentification mutuelle X.509.
Tunnels à la demande	Accès SSH, RDP, HTTP(S), VNC via le plugin Remote.
Supervision en temps réel	Collecte CPU, RAM, Disks, Containers via Metrics.
Automatisation Lua	Tâches planifiées, commandes à distance.
Protocoles industriels	Modbus RTU/TCP, CAN, HTTP, Serial, etc. via IOT.

Cas d'utilisation

Voici quelques exemples de cas où l'agent Alemca peut être utile :

1. Edge Monitoring : déployer l’agent sur un gateway ARM64 pour remonter les métriques système et les valeurs Modbus d’un onduleur.
2. Intervention hors site : déclencher un tunnel Remote vers un automate programmable isolé.
3. Automatisation intelligente : écrire un script Lua qui coupe automatiquement un moteur si la température > 90 °C pendant 30 s et envoie une métrique.

Plugins

Les plugins ajoutent des fonctionnalités spécifiques à l'agent, chacun servant un cas d'utilisation précis. Voici un aperçu des plugins fournis avec l'agent Alemca.

IOT

Le plugin IOT est conçu pour communiquer avec divers équipements utilisant différents protocoles comme Modbus, HTTP, etc. Il permet la collecte de données depuis des capteurs, actionneurs ou autres dispositifs connectés et leur envoi au service Alemca pour analyse et traitement. Il utilise le scripting Lua pour définir la logique métier et les actions à effectuer.

• Modules: Des extensions du plugin IOT permettant de supporter des protocoles spécifiques comme Modbus, HTTP, ou CAN. Chaque module doit être configuré individuellement.

• Scripts Lua: La logique métier du plugin IOT est gérée via des scripts Lua qui définissent les actions à effectuer en fonction des données collectées.

Voir la page IOT pour plus de détails sur la configuration et l'utilisation du plugin IOT.

Commands

Le plugin IOT supporte l'exécution de scripts Lua à la demande. Il est possible de déclencher l'exécution de ces scripts directement depuis l'interface d'administration Alemca onglet Commands.

Metrics

Le plugin Metrics est utilisé pour surveiller les performances des équipements. Il collecte des informations telles que l'utilisation du CPU, de la mémoire, l'état des disques, etc. en fonction du système d'exploitation (mode automatique), et les envoie au service Alemca pour une supervision centralisé. Pour plus de détails, consultez la page Metrics.

Remote

Le plugin Remote vous permet de prendre le contrôle de vos équipements à distance en créant un tunnel sécurisé entre l'agent et le service Alemca. Ce tunnel permet de se connecter à l'équipement, que ce soit localement ou via le réseau, et d'effectuer des opérations de maintenance à distance.

Cas d'utilisation :

• Dépannage et diagnostic à distance.
• Mise à jour et configuration des équipements sans avoir à se déplacer.
• Accès à des interfaces web (ou protocoles tcp,http,https,vnc) locales via un tunnel sécurisé et authentifié.

Pour plus de détails, consultez la page Remote.