Per attivare il monitoraggio web è necessario definire scenari web. Uno scenario web è composto da una o più richieste HTTP o "step". Gli step vengono eseguiti periodicamente dal server Zabbix in un ordine predefinito. Se un host è monitorato da proxy, gli step vengono eseguiti dal proxy.

Gli scenari web sono associati a host/template nello stesso modo di item, trigger, ecc. Ciò significa che gli scenari web possono essere creati anche a livello di template e poi applicati a più host in un'unica operazione.

Le seguenti informazioni vengono raccolte in qualsiasi scenario web:

velocità media di download al secondo per tutti gli step dell'intero scenario
numero dello step che è fallito
ultimo messaggio di errore

Le seguenti informazioni vengono raccolte in qualsiasi step di uno scenario web:

velocità di download al secondo
tempo di risposta
codice di risposta

Per ulteriori dettagli, vedere gli item di monitoraggio web.

I dati raccolti dall'esecuzione degli scenari web vengono conservati nel database. I dati vengono utilizzati automaticamente per grafici, trigger e notifiche.

Zabbix può anche verificare se una pagina HTML recuperata contiene una stringa predefinita. Può eseguire un accesso simulato e seguire un percorso di clic del mouse simulati sulla pagina.

Il monitoraggio web di Zabbix supporta sia HTTP sia HTTPS. Durante l'esecuzione di uno scenario web, Zabbix può facoltativamente seguire i reindirizzamenti (vedere l'opzione Follow redirects più avanti). Il numero massimo di reindirizzamenti è impostato in modo fisso a 10 (usando l'opzione cURL CURLOPT_MAXREDIRS). Tutti i cookie vengono mantenuti durante l'esecuzione di un singolo scenario.

Configurazione di uno scenario web

Per configurare uno scenario web:

Vai a: Data collection → Hosts (o Templates)
Fai clic su Web nella riga dell'host/template
Fai clic su Create web scenario a destra (oppure sul nome dello scenario per modificare uno scenario esistente)
Inserisci i parametri dello scenario nel modulo

La scheda Scenario consente di configurare i parametri generali di uno scenario web.

Tutti i campi obbligatori sono contrassegnati da un asterisco rosso.

Parametri dello scenario:

Parameter	Description
Name	Nome univoco dello scenario. Sono supportate le macro utente. Nota che, se vengono usate macro utente, queste macro resteranno non risolte nei nomi degli item di web monitoring.
Update interval	Con quale frequenza verrà eseguito lo scenario. Sono supportati i suffissi temporali, ad esempio 30s, 1m, 2h, 1d. Sono supportate le macro utente. Nota che, se viene usata una macro utente e il suo valore viene modificato (ad esempio 5m → 30s), il controllo successivo verrà eseguito in base al valore precedente (più avanti nel tempo con i valori dell'esempio). I nuovi scenari web verranno controllati entro 60 secondi dalla loro creazione.
Attempts	Numero di tentativi per l'esecuzione dei passi dello scenario web. In caso di problemi di rete (timeout, assenza di connettività, ecc.), Zabbix può ripetere l'esecuzione di un passo più volte. Il valore impostato influirà in modo uguale su ogni passo dello scenario. È possibile specificare fino a 10 tentativi; il valore predefinito è 1. Nota: Zabbix non ripeterà un passo a causa di un codice di risposta errato o della mancata corrispondenza di una stringa richiesta.
Agent	Seleziona un client agent. Zabbix si comporterà come il browser selezionato. Questo è utile quando un sito web restituisce contenuti diversi per browser diversi. In questo campo è possibile usare macro utente.
HTTP proxy	È possibile specificare un proxy HTTP da usare, nel formato `[protocol://][username[:password]@]proxy.example.com[:port]`. Questo imposta l'opzione cURL CURLOPT_PROXY. Il prefisso facoltativo `protocol://` può essere usato per specificare protocolli proxy alternativi (il supporto del prefisso del protocollo è stato aggiunto in cURL 7.21.7). Se non viene specificato alcun protocollo, il proxy verrà trattato come un proxy HTTP. Per impostazione predefinita, verrà usata la porta 1080. Se specificato, il proxy sovrascriverà le variabili di ambiente relative al proxy, come http_proxy, HTTPS_PROXY. Se non specificato, il proxy non sovrascriverà le variabili di ambiente relative al proxy. Il valore inserito viene passato "così com'è", senza alcun controllo di validità. È anche possibile inserire un indirizzo proxy SOCKS. Se si specifica il protocollo errato, la connessione fallirà e l'item diventerà non supportato. Nota che con il proxy HTTP è supportata solo l'autenticazione semplice. In questo campo è possibile usare macro utente.
Variables	Variabili che possono essere usate nei passi dello scenario (URL, variabili post). Hanno il seguente formato: {macro1}=value1 {macro2}=value2 {macro3}=regex:<regular expression> {macro4}=jsonpath:<jsonpath> {macro5}=xmlxpath:<xmlxpath> {macro6}={{macro}.function()} (vedi funzioni macro). Nota che l'uso di JSONPath, XML XPath e delle funzioni macro nelle variabili è supportato da Zabbix 7.0.4. Ad esempio: {username}=Alexei {password}=kj3h5kJ34bd {hostid}=regex:hostid is ([0-9]+) {url}=jsonpath:$.host_url {status}=xmlxpath://host/response/status {newvar}={{myvar}.btoa()} Le macro possono quindi essere richiamate nei passi come {username}, {password}, {hostid}, ecc. Zabbix le sostituirà automaticamente con i valori effettivi. Nota che le variabili con `regex:` richiedono un passo per ottenere il valore dell'espressione regolare, quindi il valore estratto può essere applicato solo al passo successivo. Se la parte del valore inizia con `regex:`, la parte successiva viene trattata come un'espressione regolare che cerca nella pagina web e, se trovata, memorizza la corrispondenza nella variabile. Deve essere presente almeno un sottogruppo, in modo che il valore corrispondente possa essere estratto. Sono supportate le macro utente e le macro}. Le variabili vengono codificate automaticamente in URL quando sono usate nei campi di query o nei dati dei moduli per le variabili post, ma devono essere codificate manualmente quando sono usate nel post raw o direttamente nell'URL.
Headers	Gli header HTTP vengono usati durante l'esecuzione di una richiesta. È possibile usare header predefiniti e personalizzati. Gli header verranno assegnati usando le impostazioni predefinite in base al tipo di Agent selezionato da un elenco a discesa a livello di scenario e verranno applicati a tutti i passi, a meno che non siano definiti come personalizzati a livello di passo. Si noti che la definizione dell'header a livello di passo scarta automaticamente tutti gli header definiti in precedenza, tranne un header predefinito assegnato selezionando 'User-Agent' da un elenco a discesa a livello di scenario. Tuttavia, anche l'header predefinito 'User-Agent' può essere sovrascritto specificandolo a livello di passo. Per rimuovere l'header a livello di scenario, l'header deve essere nominato e attribuito senza valore a livello di passo. Gli header devono essere elencati usando la stessa sintassi con cui apparirebbero nel protocollo HTTP, eventualmente utilizzando alcune funzionalità aggiuntive supportate dall'opzione cURL CURLOPT_HTTPHEADER. Ad esempio: Accept-Charset=utf-8 Accept-Language=en-US Content-Type=application/xml; charset=utf-8 Sono supportate le macro utente e le macro}.
Enabled	Lo scenario è attivo se questa casella è selezionata, altrimenti è disabilitato.

Nota che, quando si modifica uno scenario esistente, nel modulo sono disponibili due pulsanti aggiuntivi:


	Crea un altro scenario basato sulle proprietà di quello esistente.
	Elimina i dati storici e di trend dello scenario. Questo farà sì che il server esegua lo scenario immediatamente dopo l'eliminazione dei dati.

Se il campo HTTP proxy viene lasciato vuoto, un altro modo per usare un proxy HTTP è impostare le variabili di ambiente relative al proxy.

Per i controlli HTTP - imposta la variabile di ambiente http_proxy per l'utente del server Zabbix. Ad esempio, http_proxy=http://proxy_ip:proxy_port.

Per i controlli HTTPS - imposta la variabile di ambiente HTTPS_PROXY. Ad esempio, HTTPS_PROXY=http://proxy_ip:proxy_port. Ulteriori dettagli sono disponibili eseguendo il comando shell: # man curl.

La scheda Steps consente di configurare i passi dello scenario web. Per aggiungere un passo dello scenario web, fai clic su Add nel blocco Steps.

Le macro utente segrete non devono essere usate negli URL, poiché verranno risolte in "******".

Configurazione dei passaggi

Parametri del passaggio:

Parametro	Descrizione
Nome	Nome univoco del passaggio. Sono supportate le macro utente. Nota: se vengono utilizzate macro utente, queste macro rimarranno irrisolte nei nomi degli item di monitoraggio web.
URL	URL a cui connettersi e da cui recuperare i dati. Ad esempio: https://www.example.com http://www.example.com/download I nomi di dominio possono essere specificati utilizzando caratteri Unicode. Vengono automaticamente convertiti in punycode ASCII durante l'esecuzione del passaggio dello scenario web. Il pulsante Analizza può essere utilizzato per separare i campi di query facoltativi (come `?key=value&limit=10`) dall'URL, spostando attributi e valori in Campi di query per la codifica automatica dell'URL. Nell'URL è possibile utilizzare variabili mediante la sintassi {macro}. Le variabili possono essere codificate manualmente nell'URL utilizzando la sintassi {{macro}.urlencode()}. Sono supportate le macro utente e le macro `{HOST.*}`. Per motivi di sicurezza, non includere nomi utente o password reali negli URL. Utilizzare invece le macro utente per evitare di esporre le credenziali. Limitato a 2048 caratteri.
Campi di query	Variabili HTTP GET per l'URL. Specificate come coppie attributo e valore. I valori vengono codificati automaticamente nell'URL. I valori delle variabili dello scenario, delle macro utente o delle macro `{HOST.}` vengono risolti e quindi codificati automaticamente nell'URL. L'utilizzo della sintassi {{macro}.urlencode()} eseguirà una doppia codifica dell'URL. Sono supportate le macro utente e le macro `{HOST.}`.
Post	Variabili HTTP POST. Nella modalità Dati del modulo, specificate come coppie attributo e valore. I valori vengono codificati automaticamente nell'URL. I valori delle variabili dello scenario, delle macro utente o delle macro `{HOST.}` vengono risolti e quindi codificati automaticamente nell'URL. Nella modalità Dati grezzi, attributi e valori vengono visualizzati su una singola riga e concatenati con il simbolo &. I valori grezzi possono essere codificati/decodificati manualmente nell'URL utilizzando la sintassi {{macro}.urlencode()} o {{macro}.urldecode()}. Ad esempio: id=2345&userid={user} Se {user} è definita come variabile dello scenario web, verrà sostituita dal relativo valore durante l'esecuzione del passaggio. Se si desidera codificare la variabile nell'URL, sostituire {user} con {{user}.urlencode()}. Sono supportate le macro utente e le macro `{HOST.}`.
Variabili	Variabili a livello di passaggio che possono essere utilizzate per le funzioni GET e POST. Specificate come coppie attributo e valore. Le variabili a livello di passaggio hanno la precedenza sulle variabili a livello di scenario o sulle variabili del passaggio precedente. Tuttavia, il valore di una variabile a livello di passaggio influisce solo sul passaggio successivo e non su quello corrente. Hanno il seguente formato: {macro}=value {macro}=regex:<regular expression> Per ulteriori informazioni, vedere la descrizione delle variabili a livello di scenario. Le variabili vengono codificate automaticamente nell'URL quando utilizzate nei campi di query o nei dati del modulo per le variabili POST, ma devono essere codificate manualmente nell'URL quando utilizzate nei dati POST grezzi o direttamente nell'URL.
Intestazioni	Intestazioni HTTP personalizzate che verranno inviate durante l'esecuzione di una richiesta. Specificate come coppie attributo e valore. Un'intestazione definita a livello di passaggio verrà utilizzata per quel particolare passaggio. È importante notare che la definizione dell'intestazione a livello di passaggio elimina automaticamente tutte le intestazioni definite in precedenza, ad eccezione di un'intestazione predefinita assegnata selezionando 'User-Agent' dall'elenco a discesa a livello di scenario. Tuttavia, anche l'intestazione predefinita 'User-Agent' può essere sovrascritta specificandola a livello di passaggio. Ad esempio, assegnare il nome a un'intestazione senza impostare alcun valore annullerà l'intestazione predefinita a livello di scenario. Sono supportate le macro utente e le macro {HOST.*}. Imposta l'opzione cURL CURLOPT_HTTPHEADER.
Segui reindirizzamenti	Selezionare la casella di controllo per seguire i reindirizzamenti HTTP. Imposta l'opzione cURL CURLOPT_FOLLOWLOCATION.
Modalità di recupero	Selezionare la modalità di recupero: Corpo - recupera solo il corpo della risposta HTTP Intestazioni - recupera solo le intestazioni della risposta HTTP Corpo e intestazioni - recupera il corpo e le intestazioni della risposta HTTP
Timeout	Zabbix non dedicherà all'elaborazione dell'URL più del tempo impostato (da un secondo a un massimo di 1 ora). In realtà, questo parametro definisce il tempo massimo per stabilire la connessione all'URL e il tempo massimo per eseguire una richiesta HTTP. Pertanto, Zabbix non dedicherà al passaggio più di 2 x Timeout secondi. Sono supportati i suffissi temporali, ad esempio 30s, 1m, 1h. Sono supportate le macro utente.
Stringa richiesta	Pattern di espressione regolare richiesto. Il passaggio avrà esito negativo se il contenuto recuperato (HTML) non corrisponde al pattern richiesto. Se vuoto, non viene eseguito alcun controllo sulla stringa richiesta. Ad esempio: Homepage of Zabbix Welcome.admin Nota*: in questo campo non è supportato il riferimento alle espressioni regolari create nel frontend di Zabbix. Sono supportate le macro utente e le macro}.
Codici di stato richiesti	Elenco dei codici di stato HTTP previsti. Se Zabbix riceve un codice non incluso nell'elenco, il passaggio avrà esito negativo. Se vuoto, non viene eseguito alcun controllo sui codici di stato. Ad esempio: 200,201,210-299 Sono supportate le macro utente.

Le modifiche ai passaggi dello scenario web verranno salvate solo quando viene salvato l'intero scenario.

Vedere anche un esempio reale di come configurare i passaggi del monitoraggio web.

Configurazione dei tag

La scheda Tag consente di definire il livello di scenario tag.

Il tagging permette di filtrare gli scenari web e il monitoraggio web items.

Configurazione dell'autenticazione

La scheda Autenticazione consente di configurare le opzioni di autenticazione dello scenario. Un punto verde accanto al nome della scheda indica che è abilitato un tipo di autenticazione HTTP.

Parametri di autenticazione:

Parametro	Descrizione
Autenticazione HTTP	Selezionare l'opzione di autenticazione: Nessuna - non viene utilizzata alcuna autenticazione; Basic - viene utilizzata l'autenticazione di base; NTLM - viene utilizzata l'autenticazione NTLM (Windows NT LAN Manager); Kerberos - viene utilizzata l'autenticazione Kerberos (vedere anche: Configurazione di Kerberos con Zabbix); Digest - viene utilizzata l'autenticazione Digest.
Utente	Inserire il nome utente (fino a 255 caratteri). Questo campo è disponibile se Autenticazione HTTP è impostata su Basic, NTLM, Kerberos o Digest. Sono supportate le macro utente.
Password	Inserire la password dell'utente (fino a 255 caratteri). Questo campo è disponibile se Autenticazione HTTP è impostata su Basic, NTLM, Kerberos o Digest. Sono supportate le macro utente.
Verifica peer SSL	Selezionare la casella per verificare il certificato SSL del web server. Il certificato del server viene verificato rispetto ai certificati delle autorità di certificazione (CA) attendibili nella posizione CA a livello di sistema. È possibile sovrascrivere la posizione dei file CA utilizzando il parametro di configurazione del server o del proxy Zabbix SSLCALocation. Imposta l'opzione cURL CURLOPT_SSL_VERIFYPEER.
Verifica host SSL	Selezionare la casella per verificare che il campo Common Name o il campo Subject Alternate Name del certificato del web server corrisponda. Imposta l'opzione cURL CURLOPT_SSL_VERIFYHOST.
File del certificato SSL	Nome del file del certificato SSL utilizzato per l'autenticazione del client. Il file del certificato deve essere in formato PEM¹. Se il file del certificato contiene anche la chiave privata, lasciare vuoto il campo File della chiave SSL. Se la chiave è crittografata, specificare la password nel campo Password della chiave SSL. La directory contenente questo file è specificata dal parametro di configurazione del server o del proxy Zabbix SSLCertLocation. In questo campo è possibile utilizzare le macro `HOST.*` e le macro utente. Imposta l'opzione cURL CURLOPT_SSLCERT.
File della chiave SSL	Nome del file della chiave privata SSL utilizzato per l'autenticazione del client. Il file della chiave privata deve essere in formato PEM¹. La directory contenente questo file è specificata dal parametro di configurazione del server o del proxy Zabbix SSLKeyLocation. In questo campo è possibile utilizzare le macro `HOST.*` e le macro utente. Imposta l'opzione cURL CURLOPT_SSLKEY.
Password della chiave SSL	Password del file della chiave privata SSL. In questo campo è possibile utilizzare le macro utente. Imposta l'opzione cURL CURLOPT_KEYPASSWD.

[1] Zabbix supporta solo i file di certificato e di chiave privata in formato PEM. Se i dati del certificato e della chiave privata si trovano in un file in formato PKCS #12 (solitamente con estensione *.p12 o *.pfx), è possibile generare il file PEM utilizzando i seguenti comandi:

openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem
openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes  -out ssl-cert.key

Il server Zabbix rileva le modifiche ai certificati senza riavviarsi.

Se il certificato client e la chiave privata si trovano in un unico file, specificarlo nel campo "File del certificato SSL" e lasciare vuoto il campo "File della chiave SSL". Il certificato e la chiave devono comunque essere in formato PEM. È facile combinare certificato e chiave:

cat client.crt client.key > client.pem

Visualizzazione

Per visualizzare gli scenari web configurati per un host, vai in Monitoring → Hosts, individua l'host nell'elenco e fai clic sul collegamento ipertestuale Web nell'ultima colonna. Fai clic sul nome dello scenario per ottenere informazioni dettagliate.

Una panoramica degli scenari web può essere visualizzata anche in Dashboards tramite il widget di monitoraggio web.

I risultati recenti dell'esecuzione dello scenario web sono disponibili nella sezione Monitoring → Latest data.

Monitoraggio esteso

A volte è necessario registrare il contenuto della pagina HTML ricevuta.
Questo è particolarmente utile se un passaggio dello scenario web fallisce.
Il livello di debug 5 (trace) serve a questo scopo.
Questo livello può essere impostato nei file di configurazione di server e proxy oppure usando un'opzione di runtime control (-R log_level_increase="http poller,N", dove N è il numero del processo).
Gli esempi seguenti mostrano come avviare il monitoraggio esteso, a condizione che il livello di debug 4 sia già impostato:

# Increase log level of all http pollers:
zabbix_server -R log_level_increase="http poller"

# Increase log level of second http poller:
zabbix_server -R log_level_increase="http poller,2"

Se il monitoraggio web esteso non è richiesto, può essere interrotto usando l'opzione -R log_level_decrease.

Quali sono i prossimi passi?

1 Elementi di monitoraggio Web

Docs

9 Monitoraggio web

Panoramica