7 Get

Panoramica

Zabbix get è un'utilità da riga di comando che può essere utilizzata per comunicare con Zabbix agent e recuperare le informazioni richieste dall'agent.

L'utilità viene solitamente utilizzata per la risoluzione dei problemi degli agent Zabbix.

Vedere anche la libreria Python per Zabbix, che dispone di funzionalità integrate per agire come Zabbix get.

Esecuzione di Zabbix get

Un esempio di esecuzione di Zabbix get in ambiente UNIX per ottenere il valore del carico del processore dall'agent:

cd bin
./zabbix_get -s 127.0.0.1 -p 10050 -k system.cpu.load[all,avg1]

Un altro esempio di esecuzione di Zabbix get per acquisire una stringa da un sito web:

cd bin
./zabbix_get -s 192.168.1.1 -p 10050 -k "web.page.regexp[www.example.com,,,\"USA: ([a-zA-Z0-9.-]+)\",,\1]"

Si noti che la chiave item qui contiene uno spazio, quindi vengono utilizzate le virgolette per delimitare la chiave item per la shell. Le virgolette non fanno parte della chiave item; verranno rimosse dalla shell e non saranno passate a Zabbix agent.

Se una chiave item non è supportata, Zabbix get restituirà il codice di uscita 1.

Zabbix get accetta i seguenti parametri della riga di comando:

-s --host <host name or IP>             Specifica il nome host o l'indirizzo IP di un host
-p --port <port number>                 Specifica il numero di porta dell'agent in esecuzione sull'host (predefinito: 10050)
-I --source-address <IP address>        Specifica l'indirizzo IP di origine
-t --timeout <seconds>                  Specifica il timeout. Intervallo valido: 1-600 secondi (predefinito: 30 secondi)
-k --key <item key>                     Specifica la chiave dell'item di cui recuperare il valore
-P --protocol <value>                   Protocollo utilizzato per comunicare con l'agent. Valori:
                                            auto - si connette utilizzando il protocollo JSON, in caso di fallback riprova con il protocollo plaintext (predefinito)
                                            json - si connette utilizzando il protocollo JSON
                                            plaintext - si connette utilizzando il protocollo plaintext in cui viene inviata solo la chiave item (release 6.4.x e precedenti)
-h --help                               Visualizza questo messaggio di aiuto
-V --version                            Visualizza il numero di versione

--tls-connect <value>                   Modalità di connessione all'agent. Valori:
                                            unencrypted - si connette senza crittografia (predefinito)
                                            psk - si connette utilizzando TLS e una chiave precondivisa
                                            cert - si connette utilizzando TLS e un certificato
--tls-ca-file <CA file>                 Percorso completo di un file contenente i certificati della/e CA di livello superiore per la verifica del certificato del peer
--tls-crl-file <CRL file>               Percorso completo di un file contenente i certificati revocati
--tls-agent-cert-issuer <cert issuer>   Autorità emittente del certificato dell'agent consentita
--tls-agent-cert-subject <cert subject> Soggetto del certificato dell'agent consentito
--tls-cert-file <cert file>             Percorso completo di un file contenente il certificato o la catena di certificati
--tls-key-file <key file>               Percorso completo di un file contenente la chiave privata
--tls-psk-identity <PSK-identity>       Stringa univoca, con distinzione tra maiuscole e minuscole, utilizzata per identificare la chiave precondivisa
--tls-psk-file <PSK-file>               Percorso completo di un file contenente la chiave precondivisa
--tls-cipher13 <cipher-string>          Stringa di cifratura per OpenSSL 1.1.1 o versioni successive per TLS 1.3. Sovrascrive i criteri predefiniti di selezione della suite di cifratura. Questa opzione non è disponibile se la versione di OpenSSL è inferiore alla 1.1.1
--tls-cipher <cipher-string>            Stringa di priorità GnuTLS (per TLS 1.2 e superiori) o stringa di cifratura OpenSSL (solo per TLS 1.2). Sovrascrive i criteri predefiniti di selezione della suite di cifratura

Vedere anche la manpage di Zabbix get per ulteriori informazioni.

Zabbix get in Windows può essere eseguito in modo simile:

zabbix_get.exe [options]