Table of Contents
#zabbix_sender
Seção: Comandos do usuário (1)
Atualizado: 01/06/2021
Índice Retornar ao conteúdo principal
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 lê os parâmentros do servidor do arquivo de configuração agentd. 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 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 valor de porta do parâmetro ServerActive especificado no arquivo de configuração agentd.
-I, --source-address IP-address
Especifica o endereço IP de origem. Quando usado junto com --config, substitui o parâmetro SourceIP especificado no arquivo de configuração agentd.
-t, --timeout seconds
Especifica o tempo limite. Intervalo válido: 1-300 segundos (padrão: 60)
-s, --host host
Especifica 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 agentd.
-k, --key key
Especifica a chave do item para a qual enviar o valor.
-o, --value value
Especifica o valor do item.
-i, --input-file input-file
Carrega 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 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 limite de tamanho para o envio de valores de um arquivo de entrada depende do tamanho descrito no protocolo de comunicação do Zabbix. 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 data/hora Unix. Se o item de destino tem triggers que fazem referência a ele, todos os timestamps devem estar em ordem crescente, 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: <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 usadoao 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)
Index
Este documento foi criado em: 11 de junho de 2021, às 08:42:39 GMT