[comment]: # ({d2a688ac-ed2f6c13})
# 3 Moduli del frontend

[comment]: # ({/d2a688ac-ed2f6c13})

[comment]: # ({8c4f6bda-1060eddf})
#### 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](/manual/web_interface/frontend_sections/administration/general#modules)
    (in *Amministrazione* → *Generale* → *Moduli*) e fare nuovamente clic su *Scansiona
    directory* per rimuovere dal database i moduli non esistenti.

[comment]: # ({/8c4f6bda-1060eddf})

[comment]: # ({58ac3ffb-cffdc09c})
#### Installazione

Leggere sempre il manuale di installazione relativo a un 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 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 dei moduli](/manual/web_interface/frontend_sections/administration/general#modules)
    e fare clic sul pulsante *Scan 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 disponga almeno dell'accesso in lettura ed esecuzione (`r-x`) alla cartella del modulo e a tutte le sottodirectory, e dell'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 dei moduli](/manual/web_interface/frontend_sections/administration/general#modules) e fare di nuovo clic su *Scan 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 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.|

[comment]: # ({/58ac3ffb-cffdc09c})

[comment]: # ({5ca56638-26c922c0})
#### Sviluppo di moduli

Per informazioni sullo sviluppo di moduli personalizzati, vedere il [Centro sviluppatori](/devel/modules).

[comment]: # ({/5ca56638-26c922c0})