dal menu host in varie posizioni del frontend (Dashboard, Problems, Latest data, Maps, ecc.)
dal menu evento
possono essere eseguiti come operazione di un'azione

Gli script vengono eseguiti su Zabbix agent, Zabbix server (proxy) o solo su Zabbix server Vedere anche Command execution.

Sia su Zabbix agent sia su Zabbix proxy, gli script remoti sono disabilitati per impostazione predefinita. Possono essere abilitati come segue:

Per i comandi remoti eseguiti su Zabbix agent:
- aggiungendo un parametro AllowKey=system.run[<command>,*] per ogni comando consentito nella configurazione dell'agent, * indica le modalità wait e nowait;
Per i comandi remoti eseguiti su Zabbix proxy:
- Attenzione: non è necessario abilitare i comandi remoti su Zabbix proxy se i comandi remoti vengono eseguiti su Zabbix agent monitorato da Zabbix proxy. Se tuttavia è necessario eseguire comandi remoti su Zabbix proxy, impostare il parametro EnableRemoteCommands su '1' nella configurazione del proxy.

L'esecuzione degli script globali su Zabbix server può essere disabilitata impostando EnableGlobalScripts=0 nella configurazione del server. Per le nuove installazioni, a partire da Zabbix 7.0, l'esecuzione degli script globali su Zabbix server è disabilitata per impostazione predefinita.

Viene visualizzato un elenco degli script esistenti con i relativi dettagli.

Dati visualizzati:

Column	Description
Name	Nome dello script. Facendo clic sul nome dello script si apre il modulo di configurazione dello script.
Scope	Ambito dello script - operazione di un'azione, azione manuale su host o azione manuale su evento. Questa impostazione determina dove lo script è disponibile.
Used in actions	Vengono visualizzate tutte le azioni in cui lo script è utilizzato, precedute dal numero totale di tali azioni. Facendo clic sul nome dell'azione si apre il modulo di configurazione dell'azione. Se l'utente non ha i permessi per l'azione, il nome non è cliccabile.
Type	Viene visualizzato il tipo di script - URL, Webhook, Script, SSH, Telnet o comando IPMI.
Execute on	Indica se lo script verrà eseguito su Zabbix agent, Zabbix proxy o server, oppure solo su Zabbix server.
Commands	Vengono visualizzati tutti i comandi da eseguire all'interno dello script. Per i webhook qui non viene visualizzato nulla.
User group	Viene visualizzato il gruppo utente a cui lo script è disponibile (oppure All per tutti i gruppi utente).
Host group	Viene visualizzato il gruppo host per cui lo script è disponibile (oppure All per tutti i gruppi host).
Host access	Viene visualizzato il livello di autorizzazione per il gruppo host - Read o Write. Solo gli utenti con il livello di autorizzazione richiesto avranno accesso all'esecuzione dello script.

Per configurare un nuovo script, fare clic sul pulsante Create script nell'angolo in alto a destra.

Opzioni di modifica massiva

Un pulsante sotto l'elenco offre una opzione di modifica massiva:

Elimina - elimina gli script

Per usare questa opzione, seleziona le caselle di controllo accanto ai rispettivi script e fai clic su Elimina.

Uso del filtro

È possibile usare il filtro per visualizzare solo gli script di interesse. Per migliorare le prestazioni di ricerca, i dati vengono cercati con i macro non risolti.

Il link Filter è disponibile sopra l'elenco degli script. Se lo si fa clic, diventa disponibile un filtro con cui è possibile filtrare gli script per nome e ambito.

Configurazione di uno script globale

Si consiglia di usare le funzioni macro invece delle macro semplici negli script globali per migliorare la sicurezza, poiché le macro non vengono automaticamente escape.

Attributi dello script:

Parametro		Descrizione
Nome		Nome univoco dello script. Ad es. `Clear /tmp filesystem`
Ambito		Ambito dello script - operazione di action, action manuale su host o action manuale su evento. Questa impostazione determina dove lo script può essere usato - nei comandi remoti delle operazioni di action, dal menu host o dal menu evento rispettivamente. Impostare l'ambito su 'Action operation' rende lo script disponibile per tutti gli utenti con accesso a Alerts > Actions. Se uno script viene effettivamente usato in un'action, il suo ambito non può più essere modificato in modo da non essere più 'action operation'. Supporto delle macro L'ambito influisce sull'insieme delle macro disponibili. Ad esempio, le macro relative all'utente ({USER.*}) sono supportate negli script per consentire il passaggio di informazioni sull'utente che ha avviato lo script. Tuttavia, non sono supportate se l'ambito dello script è action operation, poiché le operazioni di action vengono eseguite automaticamente. La macro {MANUALINPUT} consente di specificare un input manuale al momento dell'esecuzione dello script. È supportata per gli script di action manuale su host e di action manuale su evento. Per scoprire quali altre macro sono supportate, cercare 'Trigger-based notifications and commands/Trigger-based commands', 'Manual host action scripts' e 'Manual event action scripts' nella tabella delle macro supportate. Si noti che, se una macro può risolversi in un valore con spazi (ad esempio, il nome dell'host), non dimenticare di racchiuderla tra virgolette, se necessario.
Percorso menu		Il percorso di menu desiderato per lo script. Ad esempio, `Default` o `Default/` visualizzerà lo script nella rispettiva directory. I menu possono essere annidati, ad es. `Main menu/Sub menu1/Sub menu2`. Quando si accede agli script tramite il menu host/evento nelle sezioni di monitoraggio, essi saranno organizzati in base alle directory indicate. Questo campo viene visualizzato solo se come Ambito è selezionato 'Manual host action' o 'Manual event action'.
Tipo		Fare clic sul pulsante corrispondente per selezionare il tipo di script: URL, Webhook, Script, SSH, Telnet o comando IPMI. Il tipo URL è disponibile solo quando come Ambito è selezionato 'Manual host action' o 'Manual event action'.
	Tipo di script: URL
	URL	Specificare l'URL per l'accesso rapido dal menu host o dal menu evento. Sono supportate le macro e le macro utente personalizzate. Il supporto delle macro dipende dall'ambito dello script (vedere Ambito sopra). Usare la macro {MANUALINPUT} in questo campo per poter specificare un input manuale al momento dell'esecuzione dello script, ad esempio: `http://{MANUALINPUT}/zabbix/zabbix.php?action=dashboard.view` I valori delle macro non devono essere codificati in URL.
	Apri in una nuova finestra	Determina se l'URL deve essere aperto in una nuova scheda del browser o nella stessa.
	Tipo di script: Webhook
	Parametri	Specificare le variabili del webhook come coppie attributo-valore. Vedere anche la configurazione del media Webhook. Sono supportate le macro e le macro utente personalizzate nei valori dei parametri. Il supporto delle macro dipende dall'ambito dello script (vedere Ambito sopra).
	Script	Immettere il codice JavaScript nell'editor modale che si apre facendo clic nel campo del parametro o sull'icona a forma di matita accanto ad esso. Il supporto delle macro dipende dall'ambito dello script (vedere Ambito sopra). Vedere anche la configurazione del media Webhook, Oggetti JavaScript aggiuntivi.
	Timeout	Timeout di esecuzione di JavaScript (1-60s, predefinito 30s). Sono supportati i suffissi di tempo, ad es. 30s, 1m.
	Tipo di script: Script
	Esegui su	Fare clic sul pulsante corrispondente per eseguire lo script shell su: Zabbix agent - lo script verrà eseguito da Zabbix agent (se l'item system.run è consentito) sull'host Zabbix proxy o server - lo script verrà eseguito da Zabbix proxy o server, a seconda che l'host sia monitorato da proxy o server. Verrà eseguito sul proxy se abilitato da EnableRemoteCommands. Verrà eseguito sul server se gli script globali sono abilitati dal parametro server EnableGlobalScripts. Zabbix server - lo script verrà eseguito solo da Zabbix server. Questa opzione non sarà disponibile se gli script globali sono disabilitati dal parametro server EnableGlobalScripts.
	Comandi	Immettere il percorso completo dei comandi da eseguire all'interno dello script. Il supporto delle macro dipende dall'ambito dello script (vedere Ambito sopra). Sono supportate le macro utente personalizzate.
	Tipo di script: SSH
	Metodo di autenticazione	Selezionare il metodo di autenticazione - password o chiave pubblica.
	Nome utente	Immettere il nome utente.
	Password	Immettere la password. Questo campo è disponibile se come metodo di autenticazione è selezionata 'Password'.
	File della chiave pubblica	Immettere il percorso del file della chiave pubblica. Questo campo è disponibile se come metodo di autenticazione è selezionata 'Chiave pubblica'.
	File della chiave privata	Immettere il percorso del file della chiave privata. Questo campo è disponibile se come metodo di autenticazione è selezionata 'Chiave pubblica'.
	Passphrase	Immettere la passphrase. Questo campo è disponibile se come metodo di autenticazione è selezionata 'Chiave pubblica'.
	Porta	Immettere la porta del servizio SSH remoto sull'host di destinazione a cui Zabbix si connetterà.
	Comandi	Immettere i comandi. Il supporto delle macro dipende dall'ambito dello script (vedere Ambito sopra). Sono supportate le macro utente personalizzate.
	Tipo di script: Telnet
	Nome utente	Immettere il nome utente.
	Password	Immettere la password.
	Porta	Immettere la porta del servizio Telnet remoto sull'host di destinazione a cui Zabbix si connetterà.
	Comandi	Immettere i comandi. Il supporto delle macro dipende dall'ambito dello script (vedere Ambito sopra). Sono supportate le macro utente personalizzate.
	Tipo di script: IPMI
	Comando	Immettere il comando IPMI. Il supporto delle macro dipende dall'ambito dello script (vedere Ambito sopra). Sono supportate le macro utente personalizzate.
Descrizione		Immettere una descrizione per lo script.
Gruppo host		Selezionare il gruppo host per cui lo script sarà disponibile (oppure All per tutti i gruppi host).
Gruppo utente		Selezionare il gruppo utente a cui lo script sarà disponibile (oppure All per tutti i gruppi utente). Questo campo viene visualizzato solo se come Ambito è selezionato 'Manual host action' o 'Manual event action'.
Permessi host richiesti		Selezionare il livello di autorizzazione per il gruppo host - Read o Write. Solo gli utenti con il livello di autorizzazione richiesto avranno accesso all'esecuzione dello script. Questo campo viene visualizzato solo se come Ambito è selezionato 'Manual host action' o 'Manual event action'.
Configurazione avanzata		Fare clic sull'intestazione Configurazione avanzata per visualizzare le opzioni di configurazione avanzata. Questo campo viene visualizzato solo se come Ambito è selezionato 'Manual host action' o 'Manual event action'.

Configurazione avanzata

Le opzioni di configurazione avanzata sono disponibili nella sezione comprimibile Configurazione avanzata:

Parameter	Description
Enable user input	Seleziona la casella di controllo per abilitare l'input manuale dell'utente prima dell'esecuzione dello script. L'input manuale dell'utente sostituirà il valore della macro {MANUALINPUT} nello script. Vedi anche: Input manuale dell'utente.
Input prompt	Inserisci un testo personalizzato che richieda un input utente personalizzato. Questo testo verrà visualizzato sopra il campo di input nel popup Input manuale. Per vedere un'anteprima del popup Input manuale, fai clic su Test user input. L'anteprima consente anche di verificare se la stringa di input è conforme alla regola di convalida dell'input (vedi i parametri sotto). Il supporto per macro e macro utente dipende dall'ambito dello script (vedi Scope nei parametri generali di configurazione dello script).
Input type	Seleziona il tipo di input manuale: String - stringa singola; Dropdown - il valore viene selezionato da più opzioni a discesa.
Dropdown options	Inserisci valori univoci per il menu a discesa dell'input utente in un elenco separato da virgole. Per includere un'opzione vuota nel menu a discesa, aggiungi una virgola extra all'inizio, al centro o alla fine dell'elenco. Questo campo viene visualizzato solo se Dropdown è selezionato come Input type.
Default input string	Inserisci la stringa predefinita per l'input utente (oppure nessuna). Questo campo verrà convalidato rispetto all'espressione regolare fornita nel campo Input validation rule. Il valore inserito qui verrà visualizzato per impostazione predefinita nel popup Input manuale. Questo campo viene visualizzato solo se String è selezionato come Input type.
Input validation rule	Inserisci un'espressione regolare per convalidare la stringa di input dell'utente. Sono supportate espressioni regolari globali. Questo campo viene visualizzato solo se String è selezionato come Input type.
Enable confirmation	Seleziona la casella di controllo per visualizzare un messaggio di conferma prima di eseguire lo script. Questa funzione può essere particolarmente utile per operazioni potenzialmente pericolose (come uno script di riavvio) o che potrebbero richiedere molto tempo.
Confirmation text	Inserisci un testo di conferma personalizzato per il popup di conferma abilitato con la casella di controllo sopra (ad esempio, Il sistema remoto verrà riavviato. Sei sicuro?). Per vedere come apparirà il testo, fai clic su Test confirmation accanto al campo. Sono supportati macro e user macro personalizzate. Nota: le macro non verranno espanse durante il test del messaggio di conferma.

Se sia l'input manuale dell'utente sia un messaggio di conferma sono configurati, verranno visualizzati in finestre popup consecutive.

Input utente manuale

L'input utente manuale consente di fornire un parametro personalizzato a ogni esecuzione dello script. In questo modo si evita la necessità di creare più script utente simili che differiscono solo per un singolo parametro.

Ad esempio, durante l'esecuzione potresti voler fornire allo script un numero intero diverso o un indirizzo URL diverso.

Per abilitare l'input utente manuale:

utilizzare la macro {MANUALINPUT} nello script (comandi, script, parametro dello script) dove richiesto; oppure nel campo URL degli script URL;
nella configurazione avanzata dello script, abilitare l'input utente manuale e configurare le opzioni di input.

Con l'input utente abilitato, prima dell'esecuzione dello script, all'utente verrà mostrato un popup Input manuale che richiederà di fornire un valore personalizzato. Il valore fornito sostituirà {MANUALINPUT} nello script.

A seconda della configurazione, all'utente verrà richiesto di inserire un valore stringa:

Oppure di selezionare il valore da un menu a discesa con opzioni predefinite:

L'input utente manuale è disponibile solo per gli script in cui l'ambito è 'Manual host action' o 'Manual event action'.

Esecuzione dello script e risultato

Gli script eseguiti da Zabbix server vengono eseguiti nell'ordine descritto nella pagina di esecuzione dei comandi.

Il risultato dello script viene visualizzato in una finestra pop-up che appare dopo l'esecuzione dello script. Il valore restituito dallo script è un output standard:

Se lo script termina correttamente (codice di uscita 0), il valore restituito è limitato a 16 MB (inclusi gli spazi finali che vengono troncati).
Se lo script termina con un errore (codice di uscita diverso da zero), il valore restituito è un errore standard limitato a 2 KB.

Per impostazione predefinita, Zabbix non memorizza l'output esteso dello script. Per conservare tutti i dettagli dell'output, puoi implementare la registrazione direttamente nello script (ad esempio, reindirizzando l'output a un file di log locale).

Nota che per gli script eseguiti su Zabbix server o Zabbix proxy si applicano anche i limiti del database.

Di seguito è riportato un esempio di script e della finestra dei risultati:

uname -v
/tmp/non_existing_script.sh
echo "This script was started by {USER.USERNAME}"

Il risultato dello script non mostra lo script stesso.

Timeout dello script su Zabbix agent

Potresti riscontrare una situazione in cui si verifica un timeout durante l'esecuzione di uno script.

Di seguito è riportato un esempio di uno script in esecuzione su Zabbix agent e la relativa finestra dei risultati:

sleep 5
df -h

In questo caso, il messaggio di errore è il seguente:

Timeout while executing a shell script.

Per evitare tali situazioni, si consiglia di ottimizzare lo script stesso (nell'esempio sopra, "5") invece di modificare il parametro Timeout nella configurazione di Zabbix agent e nella configurazione di Zabbix server.

Nel caso in cui il parametro Timeout sia stato modificato nella configurazione di Zabbix agent, verrà visualizzato il seguente messaggio di errore:

Get value from agent failed: ZBX_TCP_READ() timed out.

Ciò significa che la modifica è stata effettuata nella configurazione di Zabbix agent, ma è necessario modificare anche il parametro Timeout nella configurazione di Zabbix server.

Timeout degli script sugli agent attivi

È possibile eseguire gli script solo sugli agent che operano in modalità attiva. Una volta che l'esecuzione dello script viene attivata da una operazione di un'azione o dall'esecuzione manuale dello script, il comando viene incluso nella configurazione dei controlli attivi ed eseguito non appena l'agent attivo lo riceve.

Gli script manuali vengono inviati all'agent attivo insieme al timeout del server/proxy per l'esecuzione dello script. Aumentare il timeout predefinito del server/proxy per l'esecuzione dello script. Il timeout deve essere superiore alla frequenza di aggiornamento dei controlli attivi, altrimenti il timeout viene superato prima che l'agent attivo riceva lo script e sia in grado di restituire il risultato.

Timeout dello script su Zabbix server/proxy

Di seguito è riportato un esempio di uno script in esecuzione su Zabbix server e la finestra del risultato:

sleep 11
df -h

Si consiglia inoltre di ottimizzare lo script stesso (invece di regolare il parametro TrapperTimeout su un valore corrispondente (nel nostro caso, > 11) modificando la configurazione di Zabbix server).

What’s next?

8 Utenti

Docs

3 Script

Panoramica