3 Modules du frontend

Vue d’ensemble

Il est possible d’améliorer les fonctionnalités du frontend Zabbix en ajoutant des modules tiers ou en développant vos propres modules, sans avoir à modifier le code source de Zabbix.

Notez que le code du module s’exécutera avec les mêmes privilèges que le code source de Zabbix. Cela signifie que :

  • les modules tiers peuvent être dangereux. Vous devez faire confiance aux modules que vous installez ;
  • des erreurs dans le code d’un module tiers peuvent faire planter le frontend. Si cela se produit, supprimez simplement le code du module du frontend. Dès que vous rechargez le frontend Zabbix, vous verrez une note indiquant que certains modules sont absents. Accédez à Administration des modules (dans Administration → Général → Modules) et cliquez de nouveau sur Analyser le répertoire pour supprimer de la base de données les modules inexistants.

Installation

Veuillez toujours lire le manuel d'installation du module concerné. Il est recommandé d'installer les nouveaux modules un par un afin de détecter facilement les échecs.

Juste avant d'installer un module :

  • Assurez-vous d'avoir téléchargé le module depuis une source fiable. L'installation de code malveillant peut entraîner des conséquences, telles qu'une perte de données
  • Différentes versions du même module (même ID) peuvent être installées en parallèle, mais une seule version peut être activée à la fois

Étapes pour installer un module :

  • Décompressez votre module dans son propre dossier dans le dossier modules du frontend Zabbix
  • Assurez-vous que le dossier de votre module contient au minimum le fichier manifest.json
  • Accédez à l'administration des modules et cliquez sur le bouton Scan directory
  • Le nouveau module apparaîtra dans la liste avec sa version, son auteur, sa description et son statut
  • Activez le module en cliquant sur son statut

Dépannage :

Problem Solution
Le module n'est pas apparu dans la liste Si votre module n'est pas apparu dans la liste, assurez-vous que manifest.json existe dans modules/your-module/. Si ce n'est pas le cas, vous avez peut-être décompressé le module dans le mauvais répertoire. Si le fichier existe, le module peut ne pas être compatible avec votre version de Zabbix. Vérifiez également que l'utilisateur du serveur web dispose au minimum des droits de lecture et de parcours (r-x) sur le dossier du module et tous ses sous-répertoires, ainsi que des droits de lecture (r--) sur tous les fichiers qu'il contient.
Le frontend a cessé de fonctionner Le code du module n'est pas compatible avec la version actuelle de Zabbix ou avec la configuration du serveur. Veuillez supprimer les fichiers du module et recharger le frontend. Vous verrez un avis indiquant que certains modules sont absents. Accédez à l'administration des modules et cliquez de nouveau sur Scan directory pour supprimer de la base de données les modules inexistants.
Un message d'erreur concernant un espace de noms, un ID ou des actions identiques apparaît Le nouveau module a tenté d'enregistrer un espace de noms, un ID ou des actions déjà enregistrés par d'autres modules activés. Désactivez le module en conflit (mentionné dans le message d'erreur) avant d'activer le nouveau.
Des messages d'erreur techniques apparaissent Signalez les erreurs au développeur du module.

Développement de modules

Pour plus d’informations sur le développement de modules personnalisés, consultez le centre de développement.