Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

zabbix_sender

Seção: Comandos do usuário (1)
Atualizado: 2021-06-01
Index Return to Main Contents


NOME

zabbix_sender - utilitário Zabbix sender.  

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

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.

OPÇÕES

-c, --config config-file
Use config-file. Zabbix sender leia os detalhes 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 de 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 as entradas de ServerActive parâmetro especificado no arquivo de configuração agentd.

-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 entradas de porta do parâmetro ServerActive especificado em agentd arquivo de configuração.

-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 <input-file> para ler valores da entrada padrão. Cada linha de arquivo contém espaços em branco delimitado: <hostname> <chave> <valor>. Cada valor deve ser especificado em sua própria linha. Cada linha deve conter 3 espaços em branco entradas delimitadas: <hostname> <chave> <valor>, 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 <hostname> para usar o nome do host do agente arquivo de configuração ou do argumento --host.

Um exemplo de uma linha de um arquivo de entrada:

"Linux DB3" db.connections 43

O tipo de valor deve ser definido corretamente na configuração do item do Zabbix frontend. O remetente Zabbix 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: <hostname> <key> <timestamp> <value>. O timestamp deve ser especificado no formato de carimbo 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 um tipo de 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: <hostname> <key> <timestamp> <ns> <value>.

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:

unencrypted
conectar sem criptografia (default)

psk
conectar usando TLS e uma chave pré-compartilhada

cert
conectar usando TLS e um certificado

--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.

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.

 

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).

VEJA TAMBÉM

Documentação https://www.zabbix.com/manuals

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

AUTOR

Alexei Vladishev <[[email protegido]]{.__cf_email__ cfemail="0d6c6168754d776c6f6f6475236e6260"}>


 

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXIT STATUS

EXAMPLES

SEE ALSO

AUTHOR