{ "content": [ { "type": "text", "text": "# ZABBIX_GET(1) (man)\n\n**Summary:** zabbixget - Zabbix get utility\n\n**Synopsis:** zabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] -k item-key\nzabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect\ncert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-agent-cert-issuer cert-issuer]\n[--tls-agent-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file\n[--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key\nzabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect psk\n--tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string]\n[--tls-cipher cipher-string] -k item-key\nzabbixget -h\nzabbixget -V\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -s | --host | — | Specify host name or IP address of a host. |\n| -p | --port | — | Specify port number of agent running on the host. Default is 10050. |\n| -I | --source-address | — | Specify source IP address. |\n| -t | --timeout | — | Specify timeout. Valid range: 1-30 seconds (default: 30) |\n| -k | --key | — | Specify key of item to retrieve value for. --tls-connect value How to connect to agent. Values: unencrypted connect with |\n| -h | --help | — | Display this help and exit. |\n| -V | --version | — | Output version information and exit. |\n\n## Examples\n\n- `zabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\"`\n- `zabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\" --tls-connect cert`\n- `--tls-ca-file /home/zabbix/zabbixcafile --tls-agent-cert-issuer \"CN=Signing CA,OU=IT opera‐‐`\n- `tions,O=Example Corp,DC=example,DC=com\" --tls-agent-cert-subject \"CN=server1,OU=IT opera‐‐`\n- `tions,O=Example Corp,DC=example,DC=com\" --tls-cert-file /home/zabbix/zabbixget.crt`\n- `--tls-key-file /home/zabbix/zabbixget.key`\n- `zabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\" --tls-connect psk`\n- `--tls-psk-identity \"PSK ID Zabbix agentd\" --tls-psk-file /home/zabbix/zabbixagentd.psk`\n\n## See Also\n\n- zabbixagentd(8)\n- zabbixproxy(8)\n- zabbixsender(1)\n- zabbixserver(8)\n- zabbixjs(1)\n- bixagent2(8)\n- zabbixwebservice(8)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (11 lines)\n- **DESCRIPTION** (2 lines)\n- **OPTIONS** (1 lines) — 7 subsections\n - -s --host (2 lines)\n - -p --port (2 lines)\n - -I --source-address (2 lines)\n - -t --timeout (2 lines)\n - -k --key (46 lines)\n - -h --help (2 lines)\n - -V --version (2 lines)\n- **EXAMPLES** (9 lines)\n- **SEE ALSO** (8 lines)\n\n## Full Content\n\n### NAME\n\nzabbixget - Zabbix get utility\n\n### SYNOPSIS\n\nzabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] -k item-key\nzabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect\ncert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-agent-cert-issuer cert-issuer]\n[--tls-agent-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file\n[--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key\nzabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect psk\n--tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string]\n[--tls-cipher cipher-string] -k item-key\nzabbixget -h\nzabbixget -V\n\n### DESCRIPTION\n\nzabbixget is a command line utility for getting data from Zabbix agent.\n\n### OPTIONS\n\n#### -s --host\n\nSpecify host name or IP address of a host.\n\n#### -p --port\n\nSpecify port number of agent running on the host. Default is 10050.\n\n#### -I --source-address\n\nSpecify source IP address.\n\n#### -t --timeout\n\nSpecify timeout. Valid range: 1-30 seconds (default: 30)\n\n#### -k --key\n\nSpecify key of item to retrieve value for.\n\n--tls-connect value\nHow to connect to agent. Values:\n\n\nunencrypted connect without encryption (default)\n\npsk connect using TLS and a pre-shared key\n\ncert connect using TLS and a certificate\n\n--tls-ca-file CA-file\nFull pathname of a file containing the top-level CA(s) certificates for peer certifi‐\ncate verification.\n\n--tls-crl-file CRL-file\nFull pathname of a file containing revoked certificates.\n\n--tls-agent-cert-issuer cert-issuer\nAllowed agent certificate issuer.\n\n--tls-agent-cert-subject cert-subject\nAllowed agent certificate subject.\n\n--tls-cert-file cert-file\nFull pathname of a file containing the certificate or certificate chain.\n\n--tls-key-file key-file\nFull pathname of a file containing the private key.\n\n--tls-psk-identity PSK-identity\nPSK-identity string.\n\n--tls-psk-file PSK-file\nFull pathname of a file containing the pre-shared key.\n\n--tls-cipher13 cipher-string\nCipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite\nselection criteria. This option is not available if OpenSSL version is less than\n1.1.1.\n\n--tls-cipher cipher-string\nGnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS\n1.2). Override the default ciphersuite selection criteria.\n\n#### -h --help\n\nDisplay this help and exit.\n\n#### -V --version\n\nOutput version information and exit.\n\n### EXAMPLES\n\nzabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\"\nzabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\" --tls-connect cert\n--tls-ca-file /home/zabbix/zabbixcafile --tls-agent-cert-issuer \"CN=Signing CA,OU=IT opera‐‐\ntions,O=Example Corp,DC=example,DC=com\" --tls-agent-cert-subject \"CN=server1,OU=IT opera‐‐\ntions,O=Example Corp,DC=example,DC=com\" --tls-cert-file /home/zabbix/zabbixget.crt\n--tls-key-file /home/zabbix/zabbixget.key\nzabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\" --tls-connect psk\n--tls-psk-identity \"PSK ID Zabbix agentd\" --tls-psk-file /home/zabbix/zabbixagentd.psk\n\n### SEE ALSO\n\nDocumentation ⟨https://www.zabbix.com/manuals⟩\n\nzabbixagentd(8), zabbixproxy(8), zabbixsender(1), zabbixserver(8), zabbixjs(1), zab‐‐\nbixagent2(8), zabbixwebservice(8)\n\n\n\nZabbix 2022-01-06 ZABBIXGET(1)\n\n" } ], "structuredContent": { "command": "ZABBIX_GET", "section": "1", "mode": "man", "summary": "zabbixget - Zabbix get utility", "synopsis": "zabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] -k item-key\nzabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect\ncert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-agent-cert-issuer cert-issuer]\n[--tls-agent-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file\n[--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key\nzabbixget -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect psk\n--tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string]\n[--tls-cipher cipher-string] -k item-key\nzabbixget -h\nzabbixget -V", "flags": [ { "flag": "-s", "long": "--host", "arg": null, "description": "Specify host name or IP address of a host." }, { "flag": "-p", "long": "--port", "arg": null, "description": "Specify port number of agent running on the host. Default is 10050." }, { "flag": "-I", "long": "--source-address", "arg": null, "description": "Specify source IP address." }, { "flag": "-t", "long": "--timeout", "arg": null, "description": "Specify timeout. Valid range: 1-30 seconds (default: 30)" }, { "flag": "-k", "long": "--key", "arg": null, "description": "Specify key of item to retrieve value for. --tls-connect value How to connect to agent. Values: unencrypted connect without encryption (default) psk connect using TLS and a pre-shared key cert connect using TLS and a certificate --tls-ca-file CA-file Full pathname of a file containing the top-level CA(s) certificates for peer certifi‐ cate verification. --tls-crl-file CRL-file Full pathname of a file containing revoked certificates. --tls-agent-cert-issuer cert-issuer Allowed agent certificate issuer. --tls-agent-cert-subject cert-subject Allowed agent certificate subject. --tls-cert-file cert-file Full pathname of a file containing the certificate or certificate chain. --tls-key-file key-file Full pathname of a file containing the private key. --tls-psk-identity PSK-identity PSK-identity string. --tls-psk-file PSK-file Full pathname of a file containing the pre-shared key. --tls-cipher13 cipher-string Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. --tls-cipher cipher-string GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria." }, { "flag": "-h", "long": "--help", "arg": null, "description": "Display this help and exit." }, { "flag": "-V", "long": "--version", "arg": null, "description": "Output version information and exit." } ], "examples": [ "zabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\"", "zabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\" --tls-connect cert", "--tls-ca-file /home/zabbix/zabbixcafile --tls-agent-cert-issuer \"CN=Signing CA,OU=IT opera‐‐", "tions,O=Example Corp,DC=example,DC=com\" --tls-agent-cert-subject \"CN=server1,OU=IT opera‐‐", "tions,O=Example Corp,DC=example,DC=com\" --tls-cert-file /home/zabbix/zabbixget.crt", "--tls-key-file /home/zabbix/zabbixget.key", "zabbixget -s 127.0.0.1 -p 10050 -k \"system.cpu.load[all,avg1]\" --tls-connect psk", "--tls-psk-identity \"PSK ID Zabbix agentd\" --tls-psk-file /home/zabbix/zabbixagentd.psk" ], "see_also": [ { "name": "zabbixagentd", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/zabbixagentd/8/json" }, { "name": "zabbixproxy", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/zabbixproxy/8/json" }, { "name": "zabbixsender", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/zabbixsender/1/json" }, { "name": "zabbixserver", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/zabbixserver/8/json" }, { "name": "zabbixjs", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/zabbixjs/1/json" }, { "name": "bixagent2", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/bixagent2/8/json" }, { "name": "zabbixwebservice", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/zabbixwebservice/8/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 11, "subsections": [] }, { "name": "DESCRIPTION", "lines": 2, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-s --host", "lines": 2, "flag": "-s", "long": "--host" }, { "name": "-p --port", "lines": 2, "flag": "-p", "long": "--port" }, { "name": "-I --source-address", "lines": 2, "flag": "-I", "long": "--source-address" }, { "name": "-t --timeout", "lines": 2, "flag": "-t", "long": "--timeout" }, { "name": "-k --key", "lines": 46, "flag": "-k", "long": "--key" }, { "name": "-h --help", "lines": 2, "flag": "-h", "long": "--help" }, { "name": "-V --version", "lines": 2, "flag": "-V", "long": "--version" } ] }, { "name": "EXAMPLES", "lines": 9, "subsections": [] }, { "name": "SEE ALSO", "lines": 8, "subsections": [] } ] } }