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	Canal AMQPs vers le Backend Alemca
Extensibilité	Modules IO (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, etc. via Metrics.
Automatisation Lua	Tâches planifiées, commandes à distance via IOT.
Protocoles industriels	Modbus RTU/TCP (+ SunSpec), OPC XML-DA, 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 les 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.

• Librairies Lua : Fonctions utilitaires disponibles par défaut (json, yaml, lfs, base64).

• Modules par défaut : Modules chargés automatiquement sans configuration (alemca, config, filesync, netscan).

• Modules configurables : Extensions pour protocoles spécifiques (Modbus, MQTT, HTTP, GPIO, etc.) nécessitant une configuration YAML.

• Scripts Lua : La logique métier est définie via des scripts Lua qui exploitent les modules pour collecter des données et effectuer des actions.

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.