[comment]: # translation:outdated

[comment]: # ({143864d5-f16dd85b})
# zabbix\_sender

章节:用户命令 (1)\
更新: 2020-02-29\
[索引](#index) [返回主目录](/documentation/5.0/manpages)

------------------------------------------------------------------------

[ ]{#lbAB}

[comment]: # ({/143864d5-f16dd85b})

[comment]: # ({fb03d364-1fb3a028})
## 名称

zabbix\_sender - Zabbix sender 实用程序 [ ]{#lbAC}

[comment]: # ({/fb03d364-1fb3a028})

[comment]: # ({2d25e742-6688d7cd})
## 概要

**zabbix\_sender** \[**-v**\] **-z** *服务器* \[**-p** *端口*\] \[**-I**
*IP-地址*\] **-s** *主机* **-k** *key* **-o** *value*\
**zabbix\_sender** \[**-v**\] **-z** *服务器* \[**-p** *端口*\] \[**-I**
*IP地址*\] \[**-s** *主机*\] \[**-T**\] \[**-r**\] **-i** *输入文件*\
**zabbix\_sender** \[**-v**\] **-c** *配置文件* \[**-z** *服务器*\]
\[**-p** *端口*\] \[**-I** *IP地址*\] \[**-s** *主机*\] **-k** *key*
**-o** *value*\
**zabbix\_sender** \[**-v**\] **-c** *配置文件* \[**-z** *服务器*\]
\[**-p** *端口*\] \[**-I** *IP地址*\] \[**-s** *主机*\] \[**-T**\]
\[**-r**\] **-i** *输入文件*\
**zabbix\_sender** \[**-v**\] **-z** *服务器* \[**-p** *端口*\] \[**-I**
*IP地址*\] **-s** *主机* **--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* **-k** *key* **-o** *value*\
**zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I**
*IP-address*\] \[**-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* \[**-T**\] \[**-r**\] **-i**
*input-file*\
**zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\]
\[**-p** *port*\] \[**-I** *IP-address*\] \[**-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* **-k**
*key* **-o** *value*\
**zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\]
\[**-p** *port*\] \[**-I** *IP-address*\] \[**-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* \[**-T**\]
\[**-r**\] **-i** *input-file*\
**zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I**
*IP-address*\] **-s** *host* **--tls-connect** **psk**
**--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file*
**-k** *key* **-o** *value*\
**zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I**
*IP-address*\] \[**-s** *host*\] **--tls-connect** **psk**
**--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file*
\[**-T**\] \[**-r**\] **-i** *input-file*\
**zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\]
\[**-p** *port*\] \[**-I** *IP-address*\] \[**-s** *host*\]
**--tls-connect** **psk** **--tls-psk-identity** *PSK-identity*
**--tls-psk-file** *PSK-file* **-k** *key* **-o** *value*\
**zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\]
\[**-p** *port*\] \[**-I** *IP-address*\] \[**-s** *host*\]
**--tls-connect** **psk** **--tls-psk-identity** *PSK-identity*
**--tls-psk-file** *PSK-file* \[**-T**\] \[**-r**\] **-i** *input-file*\
**zabbix\_sender -h**\
**zabbix\_sender -V** [ ]{#lbAD}

[comment]: # ({/2d25e742-6688d7cd})

[comment]: # ({d4c067eb-14895cca})
## 描述

**zabbix\_sender** 是一个命令行实用程序，用于将监视数据发送到Zabbix
server 或 proxy。在Zabbixserver 上，应使用相应的密钥创建**Zabbix
trapper**类型的项目。请注意，此值仅接受来自**允许的主机**字段中指定的主机的值。
[ ]{#lbAE}

[comment]: # ({/d4c067eb-14895cca})

[comment]: # ({56d7d0a3-f3e08ea3})
## 选项

**-c**, **--config** *配置文件*  
使用*config-file*。 **Zabbix
sender**从代理配置文件中读取服务器详细信息。默认情况下， **Zabbix
sender**
不读取任何配置文件。参数只有**Hostname**，**ServerActive**，**SourceIP**，**TLSConnect**，**TLSCAFile**，**TLSCRLFile**，
**TLSServerCertIssuer**，**TLSServerCertSubject**，**TLSCertFile**，**TLSKeyFile**，**TLSPSKIdentity**
和**TLSPSKFile**支持。在agent中定义**ServerActive**的所有地址配置参数用于发送数据。如果批处理数据发送到一个地址失败，则以下批处理不会发送到该地址。

**-z**, **--zabbix-server** *server*  
Zabbix
server的主机名或IP地址。如果主机由代理监视，则应改用代理主机名或IP地址。与**--config**一起使用时，将覆盖代理配置文件中指定的**ServerActive**参数的条目。

**-p**, **--port** *port*  
指定服务器上运行的Zabbix服务器陷阱程序的端口号。缺省值为10051。与**--config**一起使用时，将覆盖代理配置文件中指定的**ServerActive**参数的端口条目.

**-I**, **--source-address** *IP-address*  
指定源IP地址。当与一起使用**--config**，覆盖**SourceIP**在agentd配置文件中指定的参数.

**-s**, **--host** *host*  
指定项目所属的主机名（在Zabbix前端中注册）。主机IP地址和DNS名称将不起作用。与**--config**一起使用时，将覆盖代理配置文件中指定的**Hostname**参数.

**-k**, **--key** *key*  
指定要发送值的项目键.

**-o**, **--value** *value*  
指定项目值.

**-i**, **--input-file** *input-file*  
从输入文件加载值。指定**-** as
从标准输入读取值。文件的每一行包含分隔的空格:
。每个值必须在自己的行中指定。每一行必须包含3个由空格分隔的条目:
，其中**<hostname> <key>
<value>**是被监控主机在Zabbix前端注册的名称，“key”是目标项目的key，“value”是要发送的值。指定**-**as
以使用代理配置文件中的 **<hostname>** 或 **--host**参数

输入文件的一行示例:

**"Linux DB3" db.connections 43**

必须在Zabbix前端的项目配置中正确设置值类型。Zabbix发件人将在一个连接中最多发送250个值。输入文件的内容必须采用UTF-8编码。输入文件中的所有值均按自上而下的顺序发送。条目必须使用以下规则设置格式:

  
  
•  
支持带引号和不带引号的条目.

•  
双引号是引号字符.

•  
带有空格的条目必须用引号引起来.

•  
带引号的条目中的双引号和反斜杠字符必须以反斜杠转义.

•  
未引用的条目不支持转义.

•  
带引号的字符串支持换行转义序列（\\n）.

•  
从条目的末尾开始修剪换行符转义序列.

**-T**, **--with-timestamps**  
此选项只能与**--input-file**选项一起使用。
输入文件的每一行必须包含4个以空格分隔的条目：**<hostname>
<key> <timestamp>
<value>**。时间戳记应以Unix时间戳记格式指定。如果目标项目具有引用它的触发器，则所有时间戳记必须按升序排列，否则事件计算将不正确.

输入文件的一行示例:

**"Linux DB3" db.connections 1429533600 43**

有关更多详细信息，请参见选项 **--input-file**.

如果为“无数据”维护类型的主机发送带有时间戳的值，则该值将被删除；否则，该值将被删除。但是，可以在过期的维护期内发送带有时间戳的值，并且该值将被接受.

**-N**, **--with-ns**  
该选项只能与--with-timestamps选项一起使用。
输入文件的每一行必须包含5个以空格分隔的条目：**<hostname>
<key> <timestamp> <value>** 输入文件的一行示例:

**"Linux DB3" db.connections 1429533600 7402561 43**

有关更多详细信息，请参见选项 **--input-file**.

**-r**, **--real-time**  
收到值后立即一一发送。从标准输入读取时可以使用此功能.

**--tls-connect** *value*  
如何连接到server 或proxy。值:

[ ]{#lbAF}

[comment]: # ({/56d7d0a3-f3e08ea3})

[comment]: # ({3a60c5e3-4029bd0a})
### 

  
**unencrypted**  
不加密连接（默认）

```{=html}
<!-- -->
```
  
**psk**  
c使用TLS和预共享密钥进行连接

```{=html}
<!-- -->
```
  
**cert**  
使用TLS和证书进行连接

```{=html}
<!-- -->
```
**--tls-ca-file** *CA-file*  
包含用于对等证书验证的顶级CA证书的文件的完整路径名.

**--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-psk-identity** *PSK-identity*  
PSK身份字符串.

**--tls-psk-file** *PSK-file*  
包含预共享密钥的文件的完整路径名.

**--tls-cipher13** *cipher-string*  
OpenSSL 1.1.1或TLS
1.3或更高版本的密码字符串。覆盖默认密码套件选择条件。如果OpenSSL版本低于1.1.1，则此选项不可用.

**--tls-cipher** *cipher-string*  
GnuTLS优先级字符串（用于TLS
1.2及更高版本）或OpenSSL密码字符串（仅用于TLS
1.2）。覆盖默认密码套件选择条件.

**-v**, **--verbose**  
详细模式，**-vv**了解更多详细信息.

**-h**, **--help**  
显示此帮助并退出.

**-V**, **--version**  
输出版本信息并退出.

[ ]{#lbAG}

[comment]: # ({/3a60c5e3-4029bd0a})

[comment]: # ({c8e9cb3f-965bb13b})
## 退出状态

如果已发送值并且服务器已成功处理所有值，则退出状态为0。如果发送了数据，但是至少一个值的处理失败，则退出状态为2。如果数据发送失败，则退出状态为1.

[ ]{#lbAH}

[comment]: # ({/c8e9cb3f-965bb13b})

[comment]: # ({8cad1dfb-9b276166})
## 例子

**zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o
342.45**\

  
发送342.45作为受监视主机的mysql.queries项目的值。使用代理配置文件中定义的受监视主机和Zabbix服务器

**zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host"
-k mysql.queries -o 342.45**\

  
使用代理配置文件中定义的Zabbix服务器
发送342.45作为“受监视的主机”主机的mysql.queries项目的值.

\
**zabbix\_sender -z 192.168.1.113 -i data\_values.txt**

  
\
将文件data\_values.txt中的值发送到IP为192.168.1.113的Zabbix
server。主机名和密钥在文件中定义.

\
**echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c
/usr/local/etc/zabbix\_agentd.conf -T -i -**\

  
将带有时间戳的值从命令行发送到代理配置文件中指定的Zabbix服务器。输入数据中的短划线表示还应从同一配置文件中使用主机名.

\
**echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z
192.168.1.113 -p 10000 -i -**\

  
从命令行在端口10000上将空值的项目发送到IP地址为192.168.1.113的Zabbix服务器。空值必须用空双引号表示.

**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**\

  
使用带有证书的TLS
将342.45作为“受监视的主机”主机中mysql.queries项目的值发送到IP为192.168.1.113的服务器

**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**\

  
使用带有预共享密钥（PSK）的TLS
将342.45作为“受监视的主机”主机中mysql.queries项目的值发送到IP为192.168.1.113的服务器.

[ ]{#lbAI}

[comment]: # ({/8cad1dfb-9b276166})

[comment]: # ({498f8d16-67b70028})
## 另请参阅

文档 <https://www.zabbix.com/manuals>

**[zabbix\_agent2](zabbix_agent2)**(8),
**[zabbix\_agentd](zabbix_agentd)**(8),
**[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1),
**[zabbix\_proxy](zabbix_proxy)**(8),
**[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI}

[comment]: # ({/498f8d16-67b70028})

[comment]: # ({883c0094-e55ed07e})
## 作者

Alexei Vladishev <<alex@zabbix.com>>

------------------------------------------------------------------------

[ ]{#index}

[comment]: # ({/883c0094-e55ed07e})

[comment]: # ({d813f0c6-43876c0e})
## 索引

[名称](#lbAB)  

[概要](#lbAC)  

[描述](#lbAD)  

[选项](#lbAE)  

[退出状态](#lbAF)  

[例子](#lbAG)  

[另请参阅](#lbAH)  

[作者](#lbAI)  

------------------------------------------------------------------------

该文档是由 man2html, 使用手册页创建的。
时间：2020年3月18日格林尼治标准时间20:49:51

[comment]: # ({/d813f0c6-43876c0e})