A tool that monitors Livebox and send data to zabbix. As this tool is targeting people using Livebox, this readme will be in french.
Cet outil utilise le webservice de la Livebox 4 pour extraire toutes les 15 secondes les données techniques du fonctionnement d'une ligne DSL. Les données sont ensuite envoyées à un serveur/proxy Zabbix. Un template est également fourni pour Zabbix(6.0) dans le dossier ZabbixTemplates. La configuration de publication est prévue pour proposer un unique binaire .net 7 self contained au format linux x64. Un dockerfile est également fourni pour conteneuriser les binaires (pratique pour faire tourner l'outil sur un nas synology par ex)
Les données extraites sont le fruit d'une observation du fonctionnement de l'interface d'administration de la livebox 4 sur une ligne ADSL donnée. Il faut noter qu'étant basé sur du rétro ingenering, d'autant plus sur une unique ligne adsl, les données extraites peuvent être incomplètes ou incorrectement interprétées. N'étant pas affilié au fournisseur d'accès internet, les spéficiations du webservice peuvent à tout moment changer.
Lors du démarrage, le programme écrit un fichier config-sample.xml. Renommer le fichier en config.xml en ajustant le contenu des noeuds en fonction de votre configuration.
<?xml version="1.0" encoding="utf-8"?>
<Configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<LiveboxUrl>http://192.168.1.1</LiveboxUrl>
<LiveboxLogin>admin</LiveboxLogin>
<LiveboxPassword>P@ssw0rd</LiveboxPassword>
<ZabbixServer>192.168.1.100</ZabbixServer>
<ZabbixHostToPopulate>adsl</ZabbixHostToPopulate>
<ZabbixServerPort>10051</ZabbixServerPort>
</Configuration>
Remarques : LiveboxUrl : ne pas mettre de / à la fin. Testé en ipv4, probablement fonctionnel en ipv6. ZabbixServer : ip ou nom d'hôte du serveur ou proxy zabbix, ipv4 ou ipv6(non testé) ZabbixHostToPopulate : nom d'hote de livebox dans Zabbix
En cas de fonctionnement dans Zabbix, voici la liste des équivalences avec le fichier de configuration :
| Variable d'environnement | Noeud xml |
|---|---|
| LTZ_LiveboxUrl | LiveboxUrl |
| LiveboxLogin | LTZ_LiveboxLogin |
| LiveboxPassword | LTZ_LiveboxPassword |
| ZabbixServer | LTZ_ZabbixServer |
| ZabbixHostToPopulate | LTZ_ZabbixHostToPopulate |
| ZabbixServerPort | LTZ_ZabbixServerPort |
Le système d'envoi au serveur Zabbix est une version légèrement modifiée de https://github.com/yanngg33/Zabbix_Sender pour pouvoir envoyer de multiples items en un seul appel au serveur.