1 Test della pre-elaborazione

Test

Testare i passaggi di preprocessing è utile per assicurarsi che pipeline di preprocessing complesse producano i risultati attesi, senza dover attendere che il valore dell'item venga ricevuto e preprocessato.

È possibile eseguire il test:

  • rispetto a un valore ipotetico
  • rispetto a un valore reale proveniente da un host

Ogni passaggio di preprocessing può essere testato singolarmente, così come tutti i passaggi possono essere testati insieme. Facendo clic sul pulsante Test o Test all steps rispettivamente nel blocco Actions, si apre una finestra di test.

Test del valore ipotetico

Parametro Descrizione
Ottieni valore da host Se vuoi testare un valore ipotetico, lascia questa casella non selezionata.
Vedi anche: Test del valore reale.
Valore Inserisci il valore di input da testare.
Facendo clic nel campo del parametro o sul pulsante visualizza/modifica si aprirà una finestra con area di testo per inserire il valore o il blocco di codice.
Non supportato Seleziona questa casella per testare un valore non supportato.
Questa opzione è utile per testare il passaggio di preprocessing Verifica valore non supportato.
Errore Inserisci il testo dell'errore.
Questo campo è abilitato quando Ottieni valore da host non è selezionato, ma Non supportato è selezionato.
Se Ottieni valore da host è selezionato, questo campo viene compilato con il messaggio di errore effettivo (sola lettura) dall'host.
Ora Viene visualizzata l'ora del valore di input: now (sola lettura).
Valore precedente Inserisci un valore di input precedente con cui confrontare.
Solo per i passaggi di preprocessing Change e Throttling.
Ora precedente Inserisci l'ora del valore di input precedente con cui confrontare.
Solo per i passaggi di preprocessing Change e Throttling.
Il valore predefinito si basa sul valore del campo 'Intervallo di aggiornamento' dell'item (se '1m', questo campo viene compilato con now-1m). Se non viene specificato nulla o l'utente non ha accesso all'host, il valore predefinito è now-30s.
Macro Se vengono utilizzate macro, queste sono elencate insieme ai rispettivi valori. I valori sono modificabili a scopo di test, ma le modifiche verranno salvate solo nel contesto del test.
Sequenza di fine riga Seleziona la sequenza di fine riga per i valori di input multilinea:
LF - sequenza LF (line feed)
CRLF - sequenza CRLF (carriage-return line-feed).
Passaggi di preprocessing I passaggi di preprocessing sono elencati; il risultato del test viene visualizzato per ciascun passaggio dopo aver fatto clic sul pulsante Test.
I risultati del test vengono troncati a una dimensione massima di 512KB quando vengono inviati al frontend. I risultati del test possono essere copiati (non oltre i 512KB troncati). Se un risultato viene troncato, viene visualizzata un'icona di avviso. La descrizione dell'avviso viene visualizzata al passaggio del mouse. Nota che i dati superiori a 512KB vengono comunque elaborati completamente da Zabbix server.
Se il passaggio fallisce durante il test, viene visualizzata un'icona di errore. La descrizione dell'errore viene visualizzata al passaggio del mouse.
Nel caso in cui per il passaggio sia specificato "Custom on fail" e tale azione venga eseguita, appare una nuova riga subito dopo la riga del passaggio di test del preprocessing, che mostra quale azione è stata eseguita e quale risultato ha prodotto (errore o valore).
Risultato Il risultato finale del test dei passaggi di preprocessing viene visualizzato in tutti i casi in cui tutti i passaggi vengono testati insieme (quando fai clic sul pulsante Test all steps).
Viene visualizzato anche il tipo di conversione al tipo di valore dell'item, ad esempio Result converted to Numeric (unsigned).
I risultati del test vengono troncati a una dimensione massima di 512KB quando vengono inviati al frontend. Il risultato finale può essere copiato (non oltre i 512KB troncati). Se un risultato viene troncato, viene visualizzata un'icona di avviso. La descrizione dell'avviso viene visualizzata al passaggio del mouse. Nota che i dati superiori a 512KB vengono comunque elaborati completamente da Zabbix server.

Fai clic su Test per vedere il risultato dopo ogni passaggio di preprocessing.

I valori di test vengono memorizzati tra le sessioni di test, sia per i singoli passaggi sia per tutti i passaggi, consentendo all'utente di modificare i passaggi di preprocessing o la configurazione dell'item e poi tornare alla finestra di test senza dover reinserire le informazioni. Tuttavia, i valori vengono persi al refresh della pagina.

Il test viene eseguito da Zabbix server. Il frontend invia una richiesta corrispondente al server e attende il risultato. La richiesta contiene il valore di input e i passaggi di preprocessing (con le macro utente espanse). Per i passaggi Change e Throttling, è possibile specificare facoltativamente un valore precedente e la relativa ora. Il server risponde con i risultati per ciascun passaggio di preprocessing.

Tutti gli errori tecnici o gli errori di validazione dell'input vengono visualizzati nel riquadro degli errori nella parte superiore della finestra di test.

Test di un valore reale

Per testare la pre-elaborazione rispetto a un valore reale:

  • Selezionare la casella Get value from host
  • Inserire o verificare i parametri del host (indirizzo del host, porta, nome del proxy/nessun proxy) e i dettagli specifici dell'item (come la community SNMPv2 o le credenziali di sicurezza SNMPv3). Questi campi dipendono dal contesto:
    • I valori vengono precompilati quando possibile, ad esempio per gli item che richiedono un agent, prendendo le informazioni dall'interfaccia agent selezionata del host
    • I valori devono essere compilati manualmente per gli item del template
    • I valori delle macro in testo semplice vengono risolti
    • Quando il valore del campo (o parte del valore) è una macro segreta o Vault, il campo sarà vuoto e dovrà essere compilato manualmente. Se un parametro dell'item contiene un valore di macro segreta, viene visualizzato il seguente messaggio di avviso: "L'item contiene macro definite dall'utente con valori segreti. I valori di queste macro devono essere inseriti manualmente."
    • I campi sono disabilitati quando non necessari nel contesto del tipo di item (ad esempio, i campi indirizzo del host e proxy sono disabilitati per gli item calcolati)
  • Fare clic su Get value and test per testare la pre-elaborazione

Se è stata specificata una mappatura dei valori nel modulo di configurazione dell'item (campo 'Show value'), la finestra di dialogo di test dell'item mostrerà un'altra riga dopo il risultato finale, denominata 'Result with value map applied'.

Parametri specifici per ottenere un valore reale da un host:

Parameter Description
Get value from host Selezionare questa casella per ottenere un valore reale dal host.
Host address Inserire l'indirizzo del host.
Questo campo viene compilato automaticamente con l'indirizzo dell'interfaccia host dell'item.
Port Inserire la porta del host.
Questo campo viene compilato automaticamente con la porta dell'interfaccia host dell'item.
Additional fields for SNMP interfaces
(SNMP version, SNMP community, Context name, etc.)		 Vedere Configuring SNMP monitoring per ulteriori dettagli sulla configurazione di un'interfaccia SNMP (v1, v2 e v3).
Questi campi vengono compilati automaticamente dall'interfaccia host dell'item.
Proxy Specificare il proxy se il host è monitorato da un proxy.
Questo campo viene compilato automaticamente con il proxy del host (se presente).
Value Valore recuperato dal host.
Facendo clic nel campo del parametro o sul pulsante di visualizzazione/modifica si aprirà una finestra con area di testo contenente il valore o il blocco di codice.
I valori vengono troncati a una dimensione massima di 512KB e solo nel frontend. Se un risultato viene troncato, viene visualizzata un'icona di avviso. La descrizione dell'avviso viene mostrata al passaggio del mouse. Si noti che i dati superiori a 512KB vengono comunque elaborati completamente da Zabbix server.

Per il resto dei parametri, vedere Testing hypothetical value sopra.