[comment]: # ({4683e02c-4dfa5936}) # zabbix\_sender Seção: Comandos do usuário (1)\ Atualizado: 2021-06-01\ [Index](#index) [Retornar ao conteúdo principal](/manpages) ------------------------------------------------------------------------- [ ]{#lbAB} [comment]: # ({/4683e02c-4dfa5936}) [comment]: # ({1fb3a028-1fb3a028}) ## NOME zabbix\_sender - utilitário Zabbix sender. [ ]{#lbAC} [comment]: # ({/1fb3a028-1fb3a028}) [comment]: # ({3f811652-3f811652}) ## SINOPSE **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* \[**--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** [ ]{#lbAD} [comment]: # ({/3f811652-3f811652}) [comment]: # ({14895cca-14895cca}) ## DESCRIÇÃO **zabbix\_sender** é um utilitário de linha de comando para enviar dados de monitoramento para o servidor ou proxy Zabbix. No servidor Zabbix um item do tipo **Zabbix trapper** deve ser criado com a chave correspondente. Observe que a entrada valores só serão aceitos de hosts especificados em **Allowed hosts** field for this item. [ ]{#lbAE} [comment]: # ({/14895cca-14895cca}) [comment]: # ({acd1c909-cd7de714}) ## OPÇÕES **-c**, **--config** *config-file* Use *config-file*. **Zabbix sender** leia os parâmentros do servidor do arquivo de configuração do agente. Por padrão **Zabbix sender** não lê nenhum arquivo de configuração. Apenas os parâmetros **Hostname**, **ServerActive**, **SourceIP**, **TLSConnect**, **TLSCAFile**, **TLSCRLFile**, **TLSServerCertIssuer**, **TLSServerCertSubject**, **TLSCertFile**, **TLSKeyFile**, **TLSPSKIdentity** e **TLSPSKFile** são suportados. Todos os endereços definidos no parâmetro de configuração **ServerActive** do agente são usados ​​para enviar dados. Se o envio de dados em lote falhar para um endereço, os seguintes lotes não são enviados para este endereço. **-z**, **--zabbix-server** *server* Hostname ou endereço IP do servidor Zabbix. Se um host é monitorado por um proxy, o hostname do proxy ou endereço IP devem ser usados. Quando usado junto com **--config**, substitui os valores do parâmetro **ServerActive** especificado no arquivo de configuração do agente. **-p**, **--port** *port* Especifique o número da porta do servidor Zabbix em execução no servidor. O padrão é 10051. Quando usado junto com **--config**, substitui o valor de porta do parâmetro **ServerActive** especificado no arquivo de configuração do agente. **-I**, **--source-address** *IP-address* Especifique o endereço IP de origem. Quando usado junto com **--config**, substitui o parâmetro **SourceIP** especificado no arquivo de configuração do agente. **-t**, **--timeout** *seconds* Especifique o tempo limite. Intervalo válido: 1-300 segundos (padrão: 60) **-s**, **--host** *host* Especifique o nome do host ao qual o item pertence (conforme registrado no Zabbix frontend). O endereço IP do host e o nome DNS não funcionarão. Quando usado junto com **--config**, substitui o parâmetro **Hostname** especificado no arquivo de configuração do agente. **-k**, **--key** *key* Especifique a chave do item para enviar o valor. **-o**, **--value** *value* Especifique o valor do item. **-i**, **--input-file** *input-file* Carregar valores do arquivo de entrada. Especifique **-** como **** para ler valores da entrada padrão. Cada linha de arquivo contém espaços em branco delimitado: ** **. Cada valor deve ser especificado em sua própria linha. Cada linha deve conter 3 espaços em branco entradas delimitadas: ** **, onde "hostname" é o nome do host monitorado conforme registrado no Zabbix frontend, "key" é a chave do item de destino e "value" - o valor a ser enviado. Especifique **-** como **** para usar o nome do host do arquivo de configuração do agente ou do argumento **--host**. Um exemplo de entradas em uma linha de arquivo: **"Linux DB3" db.connections 43** O tipo de valor deve ser definido corretamente na configuração do item do Zabbix frontend. O Zabbix Sender enviará até 250 valores em uma conexão. O conteúdo do arquivo de entrada deve estar na codificação UTF-8. Todos os valores do arquivo de entrada são enviados em ordem sequencial de cima para baixo. Entradas deve ser formatado usando as seguintes regras: • Entradas entre aspas e sem aspas são suportadas. • Aspas duplas são os caracteres de aspas • As entradas com espaço em branco devem ser citadas. • Caracteres de aspas duplas e barra invertida dentro da entrada entre aspas devem ser escapadas com uma barra invertida.. • O escape não é suportado em entradas sem aspas. • As sequências de escape de alimentação de linha (\\n) são suportadas em strings entre aspas. • As sequências de escape de alimentação de linha são cortadas a partir do final de uma entrada. **-T**, **--with-timestamps** Esta opção só pode ser usada com a opção **--input-file**. Cada linha do arquivo de entrada deve conter 4 entradas delimitadas por espaços em branco: ** **. O timestamp deve ser especificado no formato de data/hora Unix. Se o item de destino tem triggers que fazem referência a ele, todos os timestamps devem estar em um número crescente ordem, caso contrário o cálculo do evento não estará correto. Um exemplo de uma linha do arquivo de entrada: **"Linux DB3" db.connections 1429533600 43** Para mais detalhes, veja a opção **--input-file**. Se um valor com timestamp for enviado para um host que está em manutenção "no data", esse valor será descartado; porém, é possível enviar um valor com timestamp para uma manutenção expirada período e será aceito. **-N**, **--with-ns** Esta opção só pode ser usada com a opção **--with-timestamps**. Cada linha do arquivo de entrada deve conter 5 entradas delimitadas por espaços em branco: ** **. Um exemplo de uma linha do arquivo de entrada: **"Linux DB3" db.connections 1429533600 7402561 43** Para mais detalhes, veja a opção **--input-file**. **-r**, **--real-time** Envie os valores um a um assim que forem recebidos. Isso pode ser usado ao ler da entrada padrão. **--tls-connect** *value* Como se conectar ao servidor ou proxy. Valores: [ ]{#lbAF} [comment]: # ({/acd1c909-cd7de714}) [comment]: # ({4029bd0a-4029bd0a}) ### **unencrypted** conectar sem criptografia (default) ```{=html} ``` **psk** conectar usando TLS e uma chave pré-compartilhada ```{=html} ``` **cert** conectar usando TLS e um certificado ```{=html} ``` **--tls-ca-file** *CA-file* Caminho completo de um arquivo que contém os certificados de CA(s) de nível superior para verificação de certificado de peer. **--tls-crl-file** *CRL-file* Caminho completo de um arquivo contendo certificados revogados. **--tls-server-cert-issuer** *cert-issuer* Emissor de certificado de servidor permitido. **--tls-server-cert-subject** *cert-subject* Assunto do certificado do servidor permitido. **--tls-cert-file** *cert-file* Nome do caminho completo de um arquivo que contém o certificado ou cadeia de certificados. **--tls-key-file** *key-file* Caminho completo de um arquivo que contém a chave privada. **--tls-psk-identity** *PSK-identity* Cadeia de identidade PSK. **--tls-psk-file** *PSK-file* Caminho completo de um arquivo que contém a chave pré-compartilhada. **--tls-cipher13** *cipher-string* Sequência de criptografia para OpenSSL 1.1.1 ou mais recente para TLS 1.3. Substituir o critérios de seleção padrão do conjunto de cifras. Esta opção não está disponível se a versão do OpenSSL é inferior a 1.1.1. **--tls-cipher** *cipher-string* String de prioridade GnuTLS (para TLS 1.2 e superior) ou string de cifra OpenSSL (somente para TLS 1.2). Substitua os critérios de seleção padrão do ciphersuite. **-v**, **--verbose** Modo detalhado, **-vv** para mais detalhes. **-h**, **--help** Exibir esta ajuda e sair. **-V**, **--version** Informações de versão e sair. [ ]{#lbAG} [comment]: # ({/4029bd0a-4029bd0a}) [comment]: # ({965bb13b-965bb13b}) ## STATUS DE SAÍDA O status de saída é 0 se os valores foram enviados e todos eles foram processado com sucesso pelo servidor. Se os dados foram enviados, mas o processamento de pelo menos um dos valores falhou, o status de saída é 2. Se o envio de dados falhou, o status de saída é 1. [ ]{#lbAH} [comment]: # ({/965bb13b-965bb13b}) [comment]: # ({9b276166-9b276166}) ## EXEMPLOS **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Envie **342.45** como o valor para o item **mysql.queries** do host monitorado. Use host monitorado e Zabbix Server definido no arquivo de configuração do Zabbix Agent. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Envie **342.45** como o valor para o item **mysql.queries** do host **Monitored Host** usando o Zabbix Server definido no arquivo de configuração do Zabbix Agent. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Envie valores do arquivo **data\_values.txt** para o Zabbix Server com IP **192.168.1.113**. Nomes de host e keys são definidos no arquivo. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Envie um valor de timestamp da linha de comando para o Zabbix Server, especificado no arquivo de configuração do Zabbix Agent. O traço (hífen) nos dados de entrada indica que o nome do host também deve ser usado no mesmo arquivo de configuração. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Enviar valor vazio de um item para o Zabbix Server com endereço IP **192.168.1.113** na porta **10000** da linha de comando. Valores vazios deve ser indicado por aspas duplas vazias. **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**\ Envie **342.45** como o valor para o item **mysql.queries** no host **Monitored Host** para servidor com IP **192.168.1.113** usando TLS com certificado. **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**\ Envie **342.45** como o valor para o item **mysql.queries** no host **Monitored Host** para servidor com IP **192.168.1.113** usando TLS com chave pré-compartilhada (PSK). [ ]{#lbAI} [comment]: # ({/9b276166-9b276166}) [comment]: # ({554afaaf-554afaaf}) ## VEJA TAMBÉM Documentação **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} [comment]: # ({/554afaaf-554afaaf}) [comment]: # ({e55ed07e-c84769dd}) ## AUTOR Alexei Vladishev <> ------------------------------------------------------------------------ [ ]{#index} [comment]: # ({/e55ed07e-c84769dd}) [comment]: # ({d0347988-0c5a6f3e}) ## Índice [NOME](#lbAB) [SINOPSE](#lbAC) [DESCRIÇÃO](#lbAD) [OPÇÕES](#lbAE) [](#lbAF) [STATUS DE SAÍDA](#lbAG) [EXEMPLOS](#lbAH) [VEJA TAMBÉM](#lbAI) [AUTOR](#lbAJ) ------------------------------------------------------------------------ Esse documento foi criado em: 08:42:39 GMT, Junho 11, 2021 [comment]: # ({/d0347988-0c5a6f3e})