نام (NAME)

zabbix_get - ابزار دریافت داده از Zabbix

خلاصه دستور (SYNOPSIS)

zabbix_get -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] -k item-key
zabbix_get -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-agent-cert-issuer cert-issuer] [--tls-agent-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key
zabbix_get -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key
zabbix_get -h
zabbix_get -V

توضیحات (DESCRIPTION)

دستور zabbix_get یک ابزار خط فرمانی برای دریافت داده از Zabbix agent است.

گزینه‌ها (OPTIONS)

-s, --host host-name-or-IP: مشخص کردن نام میزبان یا آدرس IP میزبان.
-p, --port port-number: مشخص کردن شماره پورت agent در حال اجرا روی میزبان. پیش‌فرض 10050 است.
-I, --source-address IP-address: مشخص کردن آدرس IP مبدأ.
-t, --timeout seconds: مشخص کردن مهلت زمانی (timeout). محدوده معتبر: 1-600 ثانیه (پیش‌فرض: 30)
-k, --key item-key: مشخص کردن کلید آیتم (item key) برای بازیابی مقدار آن.
-P, --protocol value: پروتکل مورد استفاده برای برقراری ارتباط با agent. مقادیر:

auto: اتصال با استفاده از پروتکل JSON، همراه با بازگشت (fallback) و تلاش مجدد با پروتکل متن ساده (plaintext) (پیش‌فرض)

json: اتصال با استفاده از پروتکل JSON

plaintext: اتصال با استفاده از پروتکل متن ساده (plaintext) که در آن فقط کلید آیتم ارسال می‌شود (نسخه‌های 6.4.x و قدیمی‌تر)

--tls-connect value: نحوه اتصال به agent. مقادیر:

unencrypted: اتصال بدون رمزنگاری (پیش‌فرض)

psk: اتصال با استفاده از TLS و یک کلید از پیش اشتراک‌گذاری‌شده (PSK)

cert: اتصال با استفاده از TLS و یک گواهی دیجیتال

--tls-ca-file CA-file: مسیر کامل فایل حاوی گواهی‌های سطح بالای CA برای اعتبارسنجی گواهی طرف مقابل (peer).
--tls-crl-file CRL-file: مسیر کامل فایل حاوی گواهی‌های ابطال‌شده (CRL).
--tls-agent-cert-issuer cert-issuer: صادرکننده مجاز گواهی agent.
--tls-agent-cert-subject cert-subject: موضوع (subject) مجاز گواهی agent.
--tls-cert-file cert-file: مسیر کامل فایل حاوی گواهی یا زنجیره گواهی.
--tls-key-file key-file: مسیر کامل فایل حاوی کلید خصوصی.
--tls-psk-identity PSK-identity: رشته شناسه کلید از پیش اشتراک‌گذاری‌شده (PSK-identity).
--tls-psk-file PSK-file: مسیر کامل فایل حاوی کلید از پیش اشتراک‌گذاری‌شده (PSK).
--tls-cipher13 cipher-string: رشته الگوریتم‌های رمزنگاری برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. معیارهای پیش‌فرض انتخاب مجموعه‌رمز (ciphersuite) را لغو می‌کند. این گزینه در صورتی که نسخه OpenSSL کمتر از 1.1.1 باشد در دسترس نیست.
--tls-cipher cipher-string: رشته اولویت GnuTLS (برای TLS 1.2 و بالاتر) یا رشته الگوریتم‌های رمزنگاری OpenSSL (تنها برای TLS 1.2). معیارهای پیش‌فرض انتخاب مجموعه‌رمز را لغو می‌کند.
-h, --help: نمایش این راهنما و خروج.
-V, --version: نمایش اطلاعات نسخه و خروج.

وضعیت خروج (EXIT STATUS)

اگر zabbix_get مقداری را با موفقیت از Zabbix agent بازیابی کند، وضعیت خروج 0 است. اگر بازیابی مقدار با شکست مواجه شود، وضعیت خروج 1 خواهد بود.

مثال‌ها (EXAMPLES)

zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]"
zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix_get.crt --tls-key-file /home/zabbix/zabbix_get.key
zabbix_get -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/zabbix_agentd.psk

همچنین ببینید (SEE ALSO)

مستندات

zabbix_agentd(8), zabbix_proxy(8), zabbix_sender(1), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)