2 Moduli del frontend

Panoramica

È possibile estendere le funzionalità del frontend di Zabbix aggiungendo moduli di terze parti oppure sviluppando moduli personalizzati, senza la necessità di modificare il codice sorgente di Zabbix.

Si noti che il codice del modulo verrà eseguito con gli stessi privilegi del codice sorgente di Zabbix. Ciò significa che:

  • i moduli di terze parti possono essere dannosi. È necessario fidarsi dei moduli che si stanno installando;
  • gli errori nel codice di un modulo di terze parti possono causare il crash del frontend. Se ciò accade, è sufficiente rimuovere il codice del modulo dal frontend. Non appena si ricarica il frontend di Zabbix, verrà visualizzato un avviso che indica che alcuni moduli sono assenti. Andare a Amministrazione dei moduli (in Amministrazione → Generale → Moduli) e fare nuovamente clic su Scansiona directory per rimuovere dal database i moduli non esistenti.

Installazione

Leggere sempre il manuale di installazione per un modulo specifico. Si consiglia di installare i nuovi moduli uno alla volta per individuare facilmente eventuali errori.

Prima di installare un modulo:

  • Assicurarsi di aver scaricato il modulo da una fonte attendibile. L'installazione di codice dannoso può portare a conseguenze, come la perdita di dati
  • Versioni diverse dello stesso modulo (stesso ID) possono essere installate in parallelo, ma solo una singola versione può essere abilitata alla volta

Passaggi per installare un modulo:

  • Decomprimere il modulo nella propria cartella all'interno della cartella modules del frontend di Zabbix
  • Assicurarsi che la cartella del modulo contenga almeno il file manifest.json
  • Andare a Amministrazione moduli e fare clic sul pulsante Scansiona directory
  • Il nuovo modulo apparirà nell'elenco insieme alla sua versione, autore, descrizione e stato
  • Abilitare il modulo facendo clic sul suo stato

Risoluzione dei problemi:

Problema Soluzione
Il modulo non è apparso nell'elenco Se il modulo non è apparso nell'elenco, assicurarsi che manifest.json esista in modules/your-module/. Se non esiste, è possibile che il modulo sia stato decompresso nella directory sbagliata. Se invece esiste, il modulo potrebbe non essere compatibile con la versione di Zabbix in uso. Verificare inoltre che l'utente del server web abbia almeno accesso in lettura ed esecuzione (r-x) alla cartella del modulo e a tutte le sottodirectory, e accesso in lettura (r--) a tutti i file al loro interno.
Il frontend è andato in crash Il codice del modulo non è compatibile con la versione corrente di Zabbix o con la configurazione del server. Eliminare i file del modulo e ricaricare il frontend. Verrà visualizzato un avviso che indica che alcuni moduli sono assenti. Andare a Amministrazione moduli e fare di nuovo clic su Scansiona directory per rimuovere dal database i moduli inesistenti.
Appare un messaggio di errore relativo a namespace, ID o azioni identici Il nuovo modulo ha tentato di registrare un namespace, un ID o delle azioni già registrati da altri moduli abilitati. Disabilitare il modulo in conflitto (menzionato nel messaggio di errore) prima di abilitare il nuovo modulo.
Appaiono messaggi di errore tecnici Segnalare gli errori allo sviluppatore del modulo.

Sviluppo di moduli

Per informazioni sullo sviluppo di moduli personalizzati, vedere il Centro sviluppatori.