.\" 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 "<a href=""\\*(m1"">"
.      \" Yes, strip off final newline of diversion and emit it.
.      do chop URL-div
.      do URL-div
\c
.      do HTML-NS </a>
.    \}
.    el \
.      do HTML-NS "<a href=""\\*(m1"">\\*(m1</a>"
\&\\$*\"
.  \}
.  el \
\\*(la\\*(m1\\*(ra\\$*\"
.
.  hy \\n(HY
..
.TH ZABBIX_GET 1 "2022\-01\-06" Zabbix
.SH "نام (NAME)"
zabbix_get \- ابزار دریافت داده از Zabbix
.SH "خلاصه دستور (SYNOPSIS)"
.B zabbix_get \-s
.I host\-name\-or\-IP
.RB [ \-p
.IR port\-number ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.BI \-k " item\-key"
.br
.B zabbix_get \-s
.I host\-name\-or\-IP
.RB [ \-p
.IR port\-number ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.B \-\-tls\-connect
.B cert
.B \-\-tls\-ca\-file
.IR CA\-file
.RB [ \-\-tls\-crl\-file
.IR CRL\-file ]
.RB [ \-\-tls\-agent\-cert\-issuer
.IR cert\-issuer ]
.RB [ \-\-tls\-agent\-cert\-subject
.IR cert\-subject ]
.B \-\-tls\-cert\-file
.IR cert\-file
.B \-\-tls\-key\-file
.IR key\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.BI \-k " item\-key"
.br
.B zabbix_get \-s
.I host\-name\-or\-IP
.RB [ \-p
.IR port\-number ]
.RB [ \-I
.IR IP\-address ]
.RB [ \-t
.IR timeout ]
.B \-\-tls\-connect
.B psk
.B \-\-tls\-psk\-identity
.IR PSK\-identity
.B \-\-tls\-psk\-file
.IR PSK\-file
.RB [ \-\-tls\-cipher13
.IR cipher\-string ]
.RB [ \-\-tls\-cipher
.IR cipher\-string ]
.BI \-k " item\-key"
.br
.B zabbix_get \-h
.br
.B zabbix_get \-V
.SH "توضیحات (DESCRIPTION)"
دستور
.B zabbix_get
یک ابزار خط فرمانی برای دریافت داده از Zabbix agent است.
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-s\fR, \fB\-\-host\fR \fIhost\-name\-or\-IP\fR"
مشخص کردن نام میزبان یا آدرس IP میزبان.
.IP "\fB\-p\fR, \fB\-\-port\fR \fIport\-number\fR"
مشخص کردن شماره پورت agent در حال اجرا روی میزبان.
پیش‌فرض 10050 است.
.IP "\fB\-I\fR, \fB\-\-source\-address\fR \fIIP\-address\fR"
مشخص کردن آدرس IP مبدأ.
.IP "\fB\-t\fR, \fB\-\-timeout\fR \fIseconds\fR"
مشخص کردن مهلت زمانی (timeout). محدوده معتبر: 1\-600 ثانیه (پیش‌فرض: 30)
.IP "\fB\-k\fR, \fB\-\-key\fR \fIitem\-key\fR"
مشخص کردن کلید آیتم (item key) برای بازیابی مقدار آن.
.IP "\fB\-P\fR, \fB\-\-protocol\fR \fIvalue\fR"
پروتکل مورد استفاده برای برقراری ارتباط با agent. مقادیر:\fR
.SS
.RS 12
.TP 12
.B auto
اتصال با استفاده از پروتکل JSON، همراه با بازگشت (fallback) و تلاش مجدد با پروتکل متن ساده (plaintext) (پیش‌فرض)
.RE
.RS 12
.TP 12
.B json
اتصال با استفاده از پروتکل JSON
.RE
.RS 12
.TP 12
.B plaintext
اتصال با استفاده از پروتکل متن ساده (plaintext) که در آن فقط کلید آیتم ارسال می‌شود (نسخه‌های 6.4.x و قدیمی‌تر)
.RE
.RE
.IP "\fB\-\-tls\-connect\fR \fIvalue\fR"
نحوه اتصال به agent. مقادیر:\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 برای اعتبارسنجی گواهی طرف مقابل (peer).
.IP "\fB\-\-tls\-crl\-file\fR \fICRL\-file\fR"
مسیر کامل فایل حاوی گواهی‌های ابطال‌شده (CRL).
.IP "\fB\-\-tls\-agent\-cert\-issuer\fR \fIcert\-issuer\fR"
صادرکننده مجاز گواهی agent.
.IP "\fB\-\-tls\-agent\-cert\-subject\fR \fIcert\-subject\fR"
موضوع (subject) مجاز گواهی agent.
.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\-identity).
.IP "\fB\-\-tls\-psk\-file\fR \fIPSK\-file\fR"
مسیر کامل فایل حاوی کلید از پیش اشتراک‌گذاری‌شده (PSK).
.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\-h\fR, \fB\-\-help\fR"
نمایش این راهنما و خروج.
.IP "\fB\-V\fR, \fB\-\-version\fR"
نمایش اطلاعات نسخه و خروج.
.SH "وضعیت خروج (EXIT STATUS)"
اگر zabbix_get مقداری را با موفقیت از Zabbix agent بازیابی کند، وضعیت خروج 0 است. اگر بازیابی مقدار با شکست مواجه شود، وضعیت خروج 1 خواهد بود.
.SH "مثال‌ها (EXAMPLES)"
\fBzabbix_get \-s 127.0.0.1 \-p 10050 \-k "system.cpu.load[all,avg1]"\fR
.br
\fBzabbix_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
.br
\fBzabbix_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\fR
.SH "همچنین ببینید (SEE ALSO)"
.UR https://www.zabbix.com/manuals
مستندات
.UE
.PP
.BR zabbix_agentd (8),
.BR zabbix_proxy (8),
.BR zabbix_sender (1),
.BR zabbix_server (8),
.BR zabbix_js (1),
.BR zabbix_agent2 (8),
.BR zabbix_web_service (8)