.\" Start URL macro. Copied from an-ext.tmac for portability
.de UR
. ds m1 \\$1\"
. nh
. if \\n(mH \{\
. \" Start diversion in a new environment.
. do ev URL-div
. do di URL-div
. \}
..
.\" End URL macro. Copied from an-ext.tmac for portability
.de UE
. ie \\n(mH \{\
. br
. di
. ev
.
. \" Has there been one or more input lines for the link text?
. ie \\n(dn \{\
. do HTML-NS ""
. \" Yes, strip off final newline of diversion and emit it.
. do chop URL-div
. do URL-div
\c
. do HTML-NS
. \}
. el \
. do HTML-NS "\\*(m1"
\&\\$*\"
. \}
. el \
\\*(la\\*(m1\\*(ra\\$*\"
.
. hy \\n(HY
..
.TH ZABBIX_SENDER 1 "2022\-01\-06" Zabbix
.if n .ad l
.SH "نام (NAME)"
zabbix_sender \- ابزار ارسال داده Zabbix
.SH "خلاصه دستور (SYNOPSIS)"
.B zabbix_sender
.RB [ \-v ]
.B \-z
.I server
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.B \-s
.I host
.B \-k
.I key
.B \-o
.I value
.br
.B zabbix_sender
.RB [ \-v ]
.B \-z
.I server
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.RB [ \-T ]
.RB [ \-N ]
.RB [ \-r ]
.B \-i
.I input\-file
.br
.B zabbix_sender
.RB [ \-v ]
.B \-c
.I config\-file
.RB [ \-z
.IR server ]
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.B \-k
.I key
.B \-o
.I value
.br
.B zabbix_sender
.RB [ \-v ]
.B \-c
.I config\-file
.RB [ \-z
.IR server ]
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.RB [ \-T ]
.RB [ \-N ]
.RB [ \-r ]
.B \-i
.I input-file
.br
.B zabbix_sender
.RB [ \-v ]
.B \-z
.I server
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.B \-s
.I host
.B \-\-tls\-connect
.B cert
.B \-\-tls\-ca\-file
.I CA\-file
.RB [ \-\-tls\-crl\-file
.IR CRL\-file ]
.RB [ \-\-tls\-server\-cert\-issuer
.IR cert\-issuer ]
.RB [ \-\-tls\-server\-cert\-subject
.IR cert\-subject ]
.B \-\-tls\-cert\-file
.I cert\-file
.B \-\-tls\-key\-file
.I key\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.B \-k
.I key
.B \-o
.I value
.br
.B zabbix_sender
.RB [ \-v ]
.B \-z
.I server
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.B \-\-tls\-connect
.B cert
.B \-\-tls\-ca\-file
.I CA\-file
.RB [ \-\-tls\-crl\-file
.IR CRL\-file ]
.RB [ \-\-tls\-server\-cert\-issuer
.IR cert\-issuer ]
.RB [ \-\-tls\-server\-cert\-subject
.IR cert\-subject ]
.B \-\-tls\-cert\-file
.I cert\-file
.B \-\-tls\-key\-file
.I key\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.RB [ \-T ]
.RB [ \-N ]
.RB [ \-r ]
.B \-i
.I input\-file
.br
.B zabbix_sender
.RB [ \-v ]
.B \-c
.I config-file
.RB [ \-z
.IR server ]
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.B \-\-tls\-connect
.B cert
.B \-\-tls\-ca\-file
.I CA\-file
.RB [ \-\-tls\-crl\-file
.IR CRL\-file ]
.RB [ \-\-tls\-server\-cert\-issuer
.IR cert\-issuer ]
.RB [ \-\-tls\-server\-cert\-subject
.IR cert\-subject ]
.B \-\-tls\-cert\-file
.I cert\-file
.B \-\-tls\-key\-file
.I key\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.B \-k
.I key
.B \-o
.I value
.br
.B zabbix_sender
.RB [ \-v ]
.B \-c
.I config-file
.RB [ \-z
.IR server ]
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.B \-\-tls\-connect
.B cert
.B \-\-tls\-ca\-file
.I CA\-file
.RB [ \-\-tls\-crl\-file
.IR CRL\-file ]
.RB [ \-\-tls\-server\-cert\-issuer
.IR cert\-issuer ]
.RB [ \-\-tls\-server\-cert\-subject
.IR cert\-subject ]
.B \-\-tls\-cert\-file
.I cert\-file
.B \-\-tls\-key\-file
.I key\-file.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.RB [ \-T ]
.RB [ \-N ]
.RB [ \-r ]
.B \-i
.I input\-file
.br
.B zabbix_sender
.RB [ \-v ]
.B \-z
.I server
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.B \-s
.I host
.B \-\-tls\-connect
.B psk
.B \-\-tls\-psk\-identity
.I PSK\-identity
.B \-\-tls\-psk\-file
.I PSK\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.B \-k
.I key
.B \-o
.I value
.br
.B zabbix_sender
.RB [ \-v ]
.B \-z
.I server
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.B \-\-tls\-connect
.B psk
.B \-\-tls\-psk\-identity
.I PSK\-identity
.B \-\-tls\-psk\-file
.I PSK\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.RB [ \-T ]
.RB [ \-N ]
.RB [ \-r ]
.B \-i
.I input\-file
.br
.B zabbix_sender
.RB [ \-v ]
.B \-c
.I config\-file
.RB [ \-z
.IR server ]
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.B \-\-tls\-connect
.B psk
.B \-\-tls\-psk\-identity
.I PSK\-identity
.B \-\-tls\-psk\-file
.I PSK\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.B \-k
.I key
.B \-o
.I value
.br
.B zabbix_sender
.RB [ \-v ]
.B \-c
.I config\-file
.RB [ \-z
.IR server ]
.RB [ \-p
.IR port ]
.RB [ \-I
.IR IP-address ]
.RB [ \-t
.IR timeout ]
.RB [ \-s
.IR host ]
.B \-\-tls\-connect
.B psk
.B \-\-tls\-psk\-identity
.I PSK\-identity
.B \-\-tls\-psk\-file
.I PSK\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.RB [ \-T ]
.RB [ \-N ]
.RB [ \-r ]
.B \-i
.I input\-file
.br
.B zabbix_sender \-h
.br
.B zabbix_sender \-V.SH "توضیحات (DESCRIPTION)"
.B zabbix_sender
یک ابزار خط فرمانی برای ارسال دادههای پایش به Zabbix server یا proxy است.
در Zabbix server باید یک آیتم از نوع \fBZabbix trapper\fR همراه با کلید متناظر ایجاد شود.
توجه داشته باشید که مقادیر دریافتی تنها از میزبانهای مشخصشده در فیلد \fBAllowed hosts\fR برای این آیتم پذیرفته خواهند شد.
.SH "گزینهها (OPTIONS)"
.IP "\fB\-c\fR, \fB\-\-config\fR \fIconfig\-file\fR"
از \fIconfig\-file\fR استفاده میکند.
\fBZabbix sender\fR جزئیات سرور را از فایل پیکربندی agentd میخواند.
بهطور پیشفرض
.B Zabbix sender
هیچ فایل پیکربندی را نمیخواند.
تنها پارامترهای \fBHostname\fR، \fBServerActive\fR، \fBSourceIP\fR، \fBTLSConnect\fR، \fBTLSCAFile\fR، \fBTLSCRLFile\fR،
\fBTLSServerCertIssuer\fR، \fBTLSServerCertSubject\fR، \fBTLSCertFile\fR، \fBTLSKeyFile\fR، \fBTLSPSKIdentity\fR و \fBTLSPSKFile\fR پشتیبانی میشوند.
نام میزبانی که از طریق پارامتر \fBHostnameItem\fR تعریف شده باشد خوانده نخواهد شد؛ در این حالت نام میزبان باید از طریق خط فرمان مشخص شود (گزینه \-s را ببینید).
تمام نشانیهای تعریفشده در پارامتر پیکربندی \fBServerActive\fR مربوط به agent برای ارسال دادهها استفاده میشوند.
اگر ارسال دستهای دادهها به یک نشانی با شکست مواجه شود، دستههای بعدی به این نشانی ارسال نخواهند شد.
.IP "\fB\-z\fR, \fB\-\-zabbix\-server\fR \fIserver\fR"
نام میزبان یا نشانی IP مربوط به Zabbix server.
اگر یک میزبان توسط یک proxy پایش میشود، باید به جای آن از نام میزبان یا نشانی IP مربوط به proxy استفاده شود.
هنگامی که همراه با \fB\-\-config\fR استفاده شود، مقادیر پارامتر \fBServerActive\fR مشخصشده در فایل پیکربندی agentd را بازنویسی میکند.
.IP "\fB\-p\fR, \fB\-\-port\fR \fIport\fR"
شماره پورت trapper مربوط به Zabbix server را که روی سرور در حال اجرا است مشخص میکند.
پیشفرض 10051 است.
هنگامی که همراه با \fB\-\-config\fR استفاده شود، مقادیر پورت پارامتر \fBServerActive\fR مشخصشده در فایل پیکربندی agentd را بازنویسی میکند.
.IP "\fB\-I\fR, \fB\-\-source\-address\fR \fIIP\-address\fR"
نشانی IP مبدأ را مشخص میکند.
هنگامی که همراه با \fB\-\-config\fR استفاده شود، پارامتر \fBSourceIP\fR مشخصشده در فایل پیکربندی agentd را بازنویسی میکند.
.IP "\fB\-t\fR, \fB\-\-timeout\fR \fIseconds\fR"
مهلت زمانی را مشخص میکند. محدوده معتبر: ۱\-۳۰۰ ثانیه (پیشفرض: ۶۰)
.IP "\fB\-s\fR, \fB\-\-host\fR \fIhost\fR"
نام میزبان متعلق به آیتم را مشخص میکند (همانگونه که در واسط کاربری Zabbix frontend ثبت شده است).
نشانی IP میزبان و نام DNS کار نخواهند کرد.
هنگامی که همراه با \fB\-\-config\fR استفاده شود، پارامتر \fBHostname\fR مشخصشده در فایل پیکربندی agentd را بازنویسی میکند.
.IP "\fB\-k\fR, \fB\-\-key\fR \fIkey\fR"
کلید آیتم را برای ارسال مقدار به آن مشخص میکند.
.IP "\fB\-o\fR, \fB\-\-value\fR \fIvalue\fR"
مقدار آیتم را مشخص میکند.
.IP "\fB\-i\fR, \fB\-\-input\-file\fR \fIinput\-file\fR"
مقادیر را از فایل ورودی بارگذاری میکند.
برای خواندن مقادیر از ورودی استاندارد، \fB\-\fR را به عنوان \fB\fR مشخص کنید.
هر خط از فایل شامل مقادیر تفکیکشده با فاصله است: \fB \fR.
هر مقدار باید در یک خط جداگانه مشخص شود. هر خط باید شامل ۳ ورودی تفکیکشده با فاصله باشد:
\fB \fR، که در آن "hostname" نام میزبان پایششده به صورت ثبتشده در Zabbix frontend است،
"key" کلید آیتم هدف و "value" مقدار ارسالی است. برای استفاده از نام میزبان فایل پیکربندی
agent یا از آرگومان \fB\-\-host\fR، مقدار \fB-\fR را به عنوان \fB\fR مشخص کنید.
نمونهای از یک خط از فایل ورودی:
\fB "Linux DB3" db.connections 43\fR
نوع مقدار باید بهدرستی در پیکربندی آیتم در Zabbix frontend تنظیم شده باشد.
دستور Zabbix sender در هر اتصال تا ۲۵۰ مقدار را ارسال میکند.
محتوای فایل ورودی باید دارای کدگذاری UTF\-8 باشد.
تمام مقادیر فایل ورودی به ترتیب و از بالا به پایین ارسال میشوند.
ورودیها باید با استفاده از قوانین زیر قالببندی شوند:
.RS
.RS
.IP \[bu] 2
ورودیهای درون نقلقول و بدون نقلقول پشتیبانی میشوند.
.IP \[bu]
نقلقول دوگانه (Double-quote) نویسهٔ نقلقول است.
.IP \[bu]
ورودیهای دارای فاصله باید درون نقلقول قرار گیرند.
.IP \[bu]
نویسههای نقلقول دوگانه و بکاسلش در ورودیهای درون نقلقول باید با یک بکاسلش گریز داده شوند.
.IP \[bu]
گریز دادن در ورودیهای بدون نقلقول پشتیبانی نمیشود.
.IP \[bu]
توالیهای گریز خط جدید (\\n) در رشتههای درون نقلقول پشتیبانی میشوند.
.IP \[bu]
توالیهای گریز خط جدید از انتهای ورودی حذف میشوند.
.RE
.RE
.IP "\fB\-T\fR, \fB\-\-with\-timestamps\fR"
این گزینه تنها همراه با گزینهٔ \fB\-\-input\-file\fR قابل استفاده است.
هر خط از فایل ورودی باید شامل ۴ ورودی تفکیکشده با فاصله باشد: \fB \fR.
برچسب زمانی باید در قالب برچسب زمانی یونیکس (Unix timestamp) مشخص شود.
اگر آیتم هدف دارای تریگرهایی باشد که به آن ارجاع میدهند، تمام برچسبهای زمانی باید به صورت ترتیبی صعودی باشند؛ در غیر این صورت محاسبه رویدادها نادرست خواهد بود.
نمونهای از یک خط از فایل ورودی:
\fB "Linux DB3" db.connections 1429533600 43\fR
برای جزئیات بیشتر لطفاً گزینهٔ \fB\-\-input\-file\fR را ببینید.
اگر یک مقدار دارای برچسب زمانی برای میزبانی ارسال شود که در حالت نگهداری (maintenance) از نوع «بدون داده» (no data) است، این مقدار نادیده گرفته میشود؛ با این حال، ارسال مقداری دارای برچسب زمانی برای یک دورهٔ نگهداری منقضیشده ممکن است و پذیرفته خواهد شد.
.IP "\fB\-N\fR, \fB\-\-with\-ns\fR"
این گزینه تنها همراه با گزینهٔ \fB\-\-with\-timestamps\fR قابل استفاده است.
هر خط از فایل ورودی باید شامل ۵ ورودی تفکیکشده با فاصله باشد: \fB \fR.
نمونهای از یک خط از فایل ورودی:
\fB "Linux DB3" db.connections 1429533600 7402561 43\fR
برای جزئیات بیشتر لطفاً گزینهٔ \fB\-\-input\-file\fR را ببینید.
.IP "\fB\-r\fR, \fB\-\-real\-time\fR"
مقادیر را به محض دریافت به صورت تکتک ارسال میکند.
این گزینه هنگام خواندن از ورودی استاندارد کاربرد دارد.
.IP "\fB\-\-tls\-connect\fR \fIvalue\fR"
نحوهٔ اتصال به server یا proxy. مقادیر:\fR.SS
.RS 12
.TP 12
.B unencrypted
اتصال بدون رمزنگاری (پیشفرض)
.RE
.RS 12
.TP 12
.B psk
اتصال با استفاده از TLS و کلید از پیش بهاشتراکگذاشتهشده (PSK)
.RE
.RS 12
.TP 12
.B cert
اتصال با استفاده از TLS و یک گواهی
.RE
.RE
.IP "\fB\-\-tls\-ca\-file\fR \fICA\-file\fR"
مسیر کامل فایلی شامل گواهی(های) CA سطحبالا برای اعتبارسنجی گواهی همتا.
.IP "\fB\-\-tls\-crl\-file\fR \fICRL\-file\fR"
مسیر کامل فایلی شامل گواهیهای باطلشده.
.IP "\fB\-\-tls\-server\-cert\-issuer\fR \fIcert\-issuer\fR"
صادرکنندهٔ مجاز گواهی سرور.
.IP "\fB\-\-tls\-server\-cert\-subject\fR \fIcert\-subject\fR"
موضوع (subject) مجاز گواهی سرور.
.IP "\fB\-\-tls\-cert\-file\fR \fIcert\-file\fR"
مسیر کامل فایلی شامل گواهی یا زنجیرهٔ گواهی.
.IP "\fB\-\-tls\-key\-file\fR \fIkey\-file\fR"
مسیر کامل فایلی شامل کلید خصوصی.
.IP "\fB\-\-tls\-psk\-identity\fR \fIPSK\-identity\fR"
رشتهٔ شناسهٔ PSK (یا PSK\-identity).
.IP "\fB\-\-tls\-psk\-file\fR \fIPSK\-file\fR"
مسیر کامل فایلی شامل کلید از پیش بهاشتراکگذاشتهشده.
.IP "\fB\-\-tls\-cipher13\fR \fIcipher\-string\fR"
رشتهٔ رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. معیارهای پیشفرض انتخاب مجموعهٔ رمزها (ciphersuite) را لغو میکند. این گزینه در صورتی که نسخهٔ OpenSSL کمتر از 1.1.1 باشد در دسترس نیست.
.IP "\fB\-\-tls\-cipher\fR \fIcipher\-string\fR"
رشتهٔ اولویت GnuTLS (برای TLS 1.2 به بالا) یا رشتهٔ رمز OpenSSL (تنها برای TLS 1.2). معیارهای پیشفرض انتخاب مجموعهٔ رمزها را لغو میکند.
.IP "\fB\-v\fR, \fB\-\-verbose\fR"
حالت پرگویی (verbose)، مقدار \fB\-vv\fR برای جزئیات بیشتر.
.IP "\fB\-h\fR, \fB\-\-help\fR"
نمایش این راهنما و خروج.
.IP "\fB\-V\fR, \fB\-\-version\fR"
نمایش اطلاعات نسخه و خروج.
.SH "وضعیت خروج (EXIT STATUS)"
اگر مقادیر ارسال شده و همگی با موفقیت توسط سرور پردازش شوند، وضعیت خروج 0 است.
اگر دادهها ارسال شوند، اما پردازش حداقل یکی از مقادیر ناموفق باشد، وضعیت خروج 2 است.
اگر ارسال دادهها با شکست مواجه شود، وضعیت خروج 1 است.
.SH "مثالها (EXAMPLES)"
\fBzabbix_sender \-c /etc/zabbix/zabbix_agentd.conf \-k mysql.queries \-o 342.45\fR
.br
.RS
ارسال مقدار \fB342.45\fR به عنوان مقدار آیتم \fBmysql.queries\fR برای میزبان پایششده. از میزبان پایششده و سرور Zabbix تعریفشده در فایل پیکربندی عامل (agent) استفاده میکند.
.RE
\fBzabbix_sender \-c /etc/zabbix/zabbix_agentd.conf \-s "Monitored Host" \-k mysql.queries \-o 342.45\fR
.br
.RS
ارسال مقدار \fB342.45\fR به عنوان مقدار آیتم \fBmysql.queries\fR برای میزبان \fBMonitored Host\fR با استفاده از سرور Zabbix تعریفشده در فایل پیکربندی عامل.
.RE
.br
\fBzabbix_sender \-z 192.168.1.113 \-i data_values.txt\fR
.RS
.br
ارسال مقادیر از فایل \fBdata_values.txt\fR به سرور Zabbix با نشانی آیپی \fB192.168.1.113\fR.
نامهای میزبان و کلیدها درون فایل تعریف شدهاند.
.RE
.br
\fBecho "\- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender \-c /usr/local/etc/zabbix_agentd.conf \-T \-i \-\fR
.br
.RS
ارسال یک مقدار دارای برچسب زمانی (timestamped) از خط فرمان به سرور Zabbix، مشخصشده در فایل پیکربندی عامل.
خط تیره در دادههای ورودی نشان میدهد که نام میزبان نیز باید از همان فایل پیکربندی خوانده شود.
.RE
.br
\fBecho '"Zabbix server" trapper.item ""' | zabbix_sender \-z 192.168.1.113 \-p 10000 \-i \-\fR
.br
.RS
ارسال مقدار خالی یک آیتم به سرور Zabbix با نشانی آیپی \fB192.168.1.113\fR روی درگاه \fB10000\fR از طریق خط فرمان.
مقادیر خالی باید با یک جفت نقلقول دوتایی خالی مشخص شوند.
.RE
\fBzabbix_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\fR
.br
.RS
ارسال \fB342.45\fR به عنوان مقدار برای آیتم \fBmysql.queries\fR در میزبان \fBMonitored Host\fR به سرور با نشانی آیپی \fB192.168.1.113\fR با استفاده از TLS به همراه گواهی.
.RE
\fBzabbix_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\fR
.br
.RS
ارسال \fB342.45\fR به عنوان مقدار برای آیتم \fBmysql.queries\fR در میزبان \fBMonitored Host\fR به سرور با نشانی آیپی \fB192.168.1.113\fR با استفاده از TLS به همراه کلید از پیش بهاشتراکگذاشتهشده (PSK).
.RE.SH "همچنین ببینید (SEE ALSO)"
.UR https://www.zabbix.com/manuals
مستندات
.UE
.PP
.BR zabbix_agentd (8),
.BR zabbix_get (1),
.BR zabbix_proxy (8),
.BR zabbix_server (8),
.BR zabbix_js (1),
.BR zabbix_agent2 (8),
.BR zabbix_web_service (8)