Ottieni

Panoramica

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

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

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

Esecuzione di Zabbix get

Un esempio di esecuzione di Zabbix get su 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 dell'item qui contiene uno spazio, quindi vengono usate le virgolette per indicare la chiave dell'item alla shell. Le virgolette non fanno parte della chiave dell'item; verranno rimosse dalla shell e non saranno passate all'agent Zabbix.

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

Zabbix get accetta i seguenti parametri da 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 sorgente
-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 usato per comunicare con l'agent. Valori:
                                            auto - connessione tramite protocollo JSON, fallback e nuovo tentativo con protocollo plaintext (predefinito)
                                            json - connessione tramite protocollo JSON
                                            plaintext - connessione tramite protocollo plaintext in cui viene inviato solo la chiave dell'item (release 6.4.x e precedenti)
-h --help                               Mostra questo messaggio di aiuto
-V --version                            Mostra il numero di versione

--tls-connect <value>                   Modalità di connessione all'agent. Valori:
                                            unencrypted - connessione senza crittografia (predefinito)
                                            psk - connessione tramite TLS e una chiave precondivisa
                                            cert - connessione tramite TLS e un certificato
--tls-ca-file <CA file>                 Percorso completo di un file contenente i certificati 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>   Emittente del certificato dell'agent consentito
--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, sensibile alle maiuscole/minuscole, usata 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. Sostituisce i criteri di selezione predefiniti della suite di cifratura. Questa opzione non è disponibile se la versione di OpenSSL è precedente alla 1.1.1
--tls-cipher <cipher-string>            Stringa di priorità GnuTLS (per TLS 1.2 e versioni successive) o stringa di cifratura OpenSSL (solo per TLS 1.2). Sostituisce i criteri di selezione predefiniti della suite di cifratura

Per ulteriori informazioni, vedere anche la pagina man di Zabbix get.

Zabbix get su Windows può essere eseguito in modo analogo:

zabbix_get.exe [options]