Utilisation
Pour voir la liste des arguments disponibles, utiliser la commande suivante:
$ agent-alemca --help
Usage of agent-alemca:
-arch
get architecture of the agent
-config string
path to the configuration directory or file (default "/etc/alemca/configs")
-credentials string
path to the credentials file (default "/etc/alemca/credentials.yaml")
-d run the agent as a daemon
-daemon
run the agent as a daemon
-debug
run the agent in debug mode
-desactivate-autoenroll
desactivate autoenroll feature
-log-level string
log level for the logger (default "info")
-log-lua-output string
optional output file for lua logs
-log-max-age int
maximum number of days to keep a log file (default 30)
-log-max-backups int
maximum number of log files to keep (default 3)
-log-output string
output for the logger
-log-size int
maximum size of the log file in megabytes (default 100)
-name string
name of the device for autoenroll
-once
run the agent only once
-serial-number string
serial number of the device for autoenroll
-status
Print AMQP connection status and exit
-status-file string
path to the status file (default "/etc/alemca/system/status.json")
-usage-track
enable local usage tracking endpoint and counters
-version
print the version and exit
Pour lancer l'agent, utiliser la commande suivante:
Voir la configuration de l'agent.
Connexion a Alemca
L'agent utilise le protocole AMQP pour communiquer avec la plateforme Alemca. S'il y a un problème de connexion, l'agent va essayer de se reconnecter automatiquement en s'incrémentant jusqu'à un maximum 24h.
Utilisation du Script Lua
Pour utiliser le script Lua, vous devez créer un fichier dans le chemin spécifié dans la configuration. Il sera exécuté toutes les X secondes (X est spécifié dans la configuration sous trigger).
Exemple de script Lua:
local modbus = require("modbus1") -- charge le module modbus avec la configuration modbus1
local data = modbus.readHoldingRegisters(0, 10, "uint32") -- lit les registres de 0 à 10 en format uint32 (divise automatiquement en fonction du type spécifié)
for i, v in ipairs(data) do
print(i, v)
end
Voir la documentation des modules pour plus d'informations.
Usage Tracking
Il est possible de récupérer les statistiques d'utilisation de la donnée en octets de l'agent via une API locale. Pour cela, il faut activer l'option -usage-track lors du démarrage de l'agent. Cela va séparer le flux de tout les connecteur AMQP.
Pour récupérer les statistiques, il faut faire une requête HTTP GET sur le port 9191 (par défaut) à l'endpoint /usage. Exemple: