3 moduli 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 del modulo specifico. Si consiglia di installare i nuovi moduli uno alla volta, per individuare facilmente eventuali errori.

Subito prima di installare un modulo:

  • Assicurarsi di aver scaricato il modulo da una fonte affidabile. 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:

  • Estrarre 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 dei 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:

Problem Solution
Il modulo non è apparso nell'elenco Se il modulo non appare nell'elenco, assicurarsi che manifest.json esista in modules/your-module/. In caso contrario, il modulo potrebbe essere stato estratto nella directory sbagliata. Se invece esiste, il modulo potrebbe non essere compatibile con la propria versione di Zabbix. Inoltre, verificare che l'utente del web server abbia almeno accesso in lettura e ricerca (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 si è bloccato Il codice del modulo non è compatibile con l'attuale versione 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 dei moduli e fare clic di nuovo su Scansiona directory per rimuovere dal database i moduli non esistenti.
Viene visualizzato 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 (indicato nel messaggio di errore) prima di abilitare quello nuovo.
Vengono visualizzati 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.