ZABBIX_SENDER(1) General Commands Manual ZABBIX_SENDER(1)

zabbix_sender - ابزار ارسال داده Zabbix

zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s host -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s host --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file.RB [ --tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s host --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender -h
zabbix_sender -V.SH توضیحات (DESCRIPTION) zabbix_sender یک ابزار خط فرمانی برای ارسال داده‌های پایش به Zabbix server یا proxy است. در Zabbix server باید یک آیتم از نوع Zabbix trapper همراه با کلید متناظر ایجاد شود. توجه داشته باشید که مقادیر دریافتی تنها از میزبان‌های مشخص‌شده در فیلد Allowed hosts برای این آیتم پذیرفته خواهند شد.

از config-file استفاده می‌کند. Zabbix sender جزئیات سرور را از فایل پیکربندی agentd می‌خواند. به‌طور پیش‌فرض Zabbix sender هیچ فایل پیکربندی را نمی‌خواند. تنها پارامترهای Hostname، ServerActive، SourceIP، TLSConnect، TLSCAFile، TLSCRLFile، TLSServerCertIssuer، TLSServerCertSubject، TLSCertFile، TLSKeyFile، TLSPSKIdentity و TLSPSKFile پشتیبانی می‌شوند. نام میزبانی که از طریق پارامتر HostnameItem تعریف شده باشد خوانده نخواهد شد؛ در این حالت نام میزبان باید از طریق خط فرمان مشخص شود (گزینه -s را ببینید). تمام نشانی‌های تعریف‌شده در پارامتر پیکربندی ServerActive مربوط به agent برای ارسال داده‌ها استفاده می‌شوند. اگر ارسال دسته‌ای داده‌ها به یک نشانی با شکست مواجه شود، دسته‌های بعدی به این نشانی ارسال نخواهند شد.
نام میزبان یا نشانی IP مربوط به Zabbix server. اگر یک میزبان توسط یک proxy پایش می‌شود، باید به جای آن از نام میزبان یا نشانی IP مربوط به proxy استفاده شود. هنگامی که همراه با --config استفاده شود، مقادیر پارامتر ServerActive مشخص‌شده در فایل پیکربندی agentd را بازنویسی می‌کند.
شماره پورت trapper مربوط به Zabbix server را که روی سرور در حال اجرا است مشخص می‌کند. پیش‌فرض 10051 است. هنگامی که همراه با --config استفاده شود، مقادیر پورت پارامتر ServerActive مشخص‌شده در فایل پیکربندی agentd را بازنویسی می‌کند.
نشانی IP مبدأ را مشخص می‌کند. هنگامی که همراه با --config استفاده شود، پارامتر SourceIP مشخص‌شده در فایل پیکربندی agentd را بازنویسی می‌کند.
مهلت زمانی را مشخص می‌کند. محدوده معتبر: ۱-۳۰۰ ثانیه (پیش‌فرض: ۶۰)
نام میزبان متعلق به آیتم را مشخص می‌کند (همان‌گونه که در واسط کاربری Zabbix frontend ثبت شده است). نشانی IP میزبان و نام DNS کار نخواهند کرد. هنگامی که همراه با --config استفاده شود، پارامتر Hostname مشخص‌شده در فایل پیکربندی agentd را بازنویسی می‌کند.
کلید آیتم را برای ارسال مقدار به آن مشخص می‌کند.
مقدار آیتم را مشخص می‌کند.
مقادیر را از فایل ورودی بارگذاری می‌کند. برای خواندن مقادیر از ورودی استاندارد، - را به عنوان <input-file> مشخص کنید. هر خط از فایل شامل مقادیر تفکیک‌شده با فاصله است: <hostname> <key> <value>. هر مقدار باید در یک خط جداگانه مشخص شود. هر خط باید شامل ۳ ورودی تفکیک‌شده با فاصله باشد: <hostname> <key> <value>، که در آن "hostname" نام میزبان پایش‌شده به صورت ثبت‌شده در Zabbix frontend است، "key" کلید آیتم هدف و "value" مقدار ارسالی است. برای استفاده از نام میزبان فایل پیکربندی agent یا از آرگومان --host، مقدار - را به عنوان <hostname> مشخص کنید.

نمونه‌ای از یک خط از فایل ورودی:

"Linux DB3" db.connections 43

نوع مقدار باید به‌درستی در پیکربندی آیتم در Zabbix frontend تنظیم شده باشد. دستور Zabbix sender در هر اتصال تا ۲۵۰ مقدار را ارسال می‌کند. محتوای فایل ورودی باید دارای کدگذاری UTF-8 باشد. تمام مقادیر فایل ورودی به ترتیب و از بالا به پایین ارسال می‌شوند. ورودی‌ها باید با استفاده از قوانین زیر قالب‌بندی شوند:

•
ورودی‌های درون نقل‌قول و بدون نقل‌قول پشتیبانی می‌شوند.
•
نقل‌قول دوگانه (Double-quote) نویسهٔ نقل‌قول است.
•
ورودی‌های دارای فاصله باید درون نقل‌قول قرار گیرند.
•
نویسه‌های نقل‌قول دوگانه و بک‌اسلش در ورودی‌های درون نقل‌قول باید با یک بک‌اسلش گریز داده شوند.
•
گریز دادن در ورودی‌های بدون نقل‌قول پشتیبانی نمی‌شود.
•
توالی‌های گریز خط جدید (\n) در رشته‌های درون نقل‌قول پشتیبانی می‌شوند.
•
توالی‌های گریز خط جدید از انتهای ورودی حذف می‌شوند.
این گزینه تنها همراه با گزینهٔ --input-file قابل استفاده است.

هر خط از فایل ورودی باید شامل ۴ ورودی تفکیک‌شده با فاصله باشد: <hostname> <key> <timestamp> <value>. برچسب زمانی باید در قالب برچسب زمانی یونیکس (Unix timestamp) مشخص شود. اگر آیتم هدف دارای تریگرهایی باشد که به آن ارجاع می‌دهند، تمام برچسب‌های زمانی باید به صورت ترتیبی صعودی باشند؛ در غیر این صورت محاسبه رویدادها نادرست خواهد بود.

نمونه‌ای از یک خط از فایل ورودی:

"Linux DB3" db.connections 1429533600 43

برای جزئیات بیشتر لطفاً گزینهٔ --input-file را ببینید.

اگر یک مقدار دارای برچسب زمانی برای میزبانی ارسال شود که در حالت نگهداری (maintenance) از نوع «بدون داده» (no data) است، این مقدار نادیده گرفته می‌شود؛ با این حال، ارسال مقداری دارای برچسب زمانی برای یک دورهٔ نگهداری منقضی‌شده ممکن است و پذیرفته خواهد شد.

این گزینه تنها همراه با گزینهٔ --with-timestamps قابل استفاده است.

هر خط از فایل ورودی باید شامل ۵ ورودی تفکیک‌شده با فاصله باشد: <hostname> <key> <timestamp> <ns> <value>.

نمونه‌ای از یک خط از فایل ورودی:

"Linux DB3" db.connections 1429533600 7402561 43

برای جزئیات بیشتر لطفاً گزینهٔ --input-file را ببینید.

مقادیر را به محض دریافت به صورت تک‌تک ارسال می‌کند. این گزینه هنگام خواندن از ورودی استاندارد کاربرد دارد.
نحوهٔ اتصال به server یا proxy. مقادیر:.SS
اتصال بدون رمزنگاری (پیش‌فرض)
اتصال با استفاده از TLS و کلید از پیش به‌اشتراک‌گذاشته‌شده (PSK)
اتصال با استفاده از TLS و یک گواهی
مسیر کامل فایلی شامل گواهی‌(های) CA سطح‌بالا برای اعتبارسنجی گواهی همتا.
مسیر کامل فایلی شامل گواهی‌های باطل‌شده.
صادرکنندهٔ مجاز گواهی سرور.
موضوع (subject) مجاز گواهی سرور.
مسیر کامل فایلی شامل گواهی یا زنجیرهٔ گواهی.
مسیر کامل فایلی شامل کلید خصوصی.
رشتهٔ شناسهٔ PSK (یا PSK-identity).
مسیر کامل فایلی شامل کلید از پیش به‌اشتراک‌گذاشته‌شده.
رشتهٔ رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. معیارهای پیش‌فرض انتخاب مجموعهٔ رمزها (ciphersuite) را لغو می‌کند. این گزینه در صورتی که نسخهٔ OpenSSL کمتر از 1.1.1 باشد در دسترس نیست.
رشتهٔ اولویت GnuTLS (برای TLS 1.2 به بالا) یا رشتهٔ رمز OpenSSL (تنها برای TLS 1.2). معیارهای پیش‌فرض انتخاب مجموعهٔ رمزها را لغو می‌کند.
حالت پرگویی (verbose)، مقدار -vv برای جزئیات بیشتر.
نمایش این راهنما و خروج.
نمایش اطلاعات نسخه و خروج.

اگر مقادیر ارسال شده و همگی با موفقیت توسط سرور پردازش شوند، وضعیت خروج 0 است. اگر داده‌ها ارسال شوند، اما پردازش حداقل یکی از مقادیر ناموفق باشد، وضعیت خروج 2 است. اگر ارسال داده‌ها با شکست مواجه شود، وضعیت خروج 1 است.

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45

ارسال مقدار 342.45 به عنوان مقدار آیتم mysql.queries برای میزبان پایش‌شده. از میزبان پایش‌شده و سرور Zabbix تعریف‌شده در فایل پیکربندی عامل (agent) استفاده می‌کند.

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45

ارسال مقدار 342.45 به عنوان مقدار آیتم mysql.queries برای میزبان Monitored Host با استفاده از سرور Zabbix تعریف‌شده در فایل پیکربندی عامل.

zabbix_sender -z 192.168.1.113 -i data_values.txt


ارسال مقادیر از فایل data_values.txt به سرور Zabbix با نشانی آی‌پی 192.168.1.113. نام‌های میزبان و کلیدها درون فایل تعریف شده‌اند.

echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c /usr/local/etc/zabbix_agentd.conf -T -i -

ارسال یک مقدار دارای برچسب زمانی (timestamped) از خط فرمان به سرور Zabbix، مشخص‌شده در فایل پیکربندی عامل. خط تیره در داده‌های ورودی نشان می‌دهد که نام میزبان نیز باید از همان فایل پیکربندی خوانده شود.

echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

ارسال مقدار خالی یک آیتم به سرور Zabbix با نشانی آی‌پی 192.168.1.113 روی درگاه 10000 از طریق خط فرمان. مقادیر خالی باید با یک جفت نقل‌قول دوتایی خالی مشخص شوند.

zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file --tls-cert-file /home/zabbix/zabbix_agentd.crt --tls-key-file /home/zabbix/zabbix_agentd.key

ارسال 342.45 به عنوان مقدار برای آیتم mysql.queries در میزبان Monitored Host به سرور با نشانی آی‌پی 192.168.1.113 با استفاده از TLS به همراه گواهی.

zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix_agentd.psk

ارسال 342.45 به عنوان مقدار برای آیتم mysql.queries در میزبان Monitored Host به سرور با نشانی آی‌پی 192.168.1.113 با استفاده از TLS به همراه کلید از پیش به‌اشتراک‌گذاشته‌شده (PSK). مستندات

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

2022-01-06 Zabbix