Table of Contents

zabbix_sender
- NOME
- SINOPSE
- DESCRIÇÃO
- OPÇÕES
- STATUS DE SAÍDA
- EXEMPLOS
- VEJA TAMBÉM
- Índice

zabbix_sender

Seção: Comandos do Usuário (1)
Atualizado: 2021-06-01
Índice Retornar ao Conteúdo Principal

NOME

zabbix_sender - Utilitário de envio do Zabbix

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] [-g] -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] [-g] -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] [-g] -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] [-g] -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] [-g] -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] [-g] -i input-file
zabbix_sender -h
zabbix_sender -V

DESCRIÇÃO

zabbix_sender é uma ferramenta de linha de comando para enviar dados de monitoramento para o Zabbix server ou proxy. No Zabbix server, um item do tipo Zabbix trapper deve ser criado com a chave correspondente. Observe que os valores recebidos só serão aceitos de hosts especificados no campo Allowed hosts para este item.

OPÇÕES

-c, --config config-file
Usa config-file. O Zabbix sender lê os detalhes do server a partir do arquivo de configuração do agentd. Por padrão, 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. O Hostname definido através do parâmetro HostnameItem não será considerado, neste caso o hostname deve ser especificado via linha de comando (veja a opção -s). Todos os endereços definidos no parâmetro de configuração ServerActive do agent são usados para enviar dados. Se o envio de dados em lote falhar para um endereço, os lotes seguintes não são enviados para esse endereço.

-z, --zabbix-server server
Nome do host ou endereço IP do Zabbix server. Se um host for monitorado por um proxy, o hostname ou endereço IP do proxy deve ser usado. Quando usado junto com --config, sobrescreve as entradas do parâmetro ServerActive especificado no arquivo de configuração do agentd.

-p, --port port
Especifica o número da porta do trapper do Zabbix server em execução no server. O padrão é 10051. Quando usado junto com --config, sobrescreve as entradas de porta do parâmetro ServerActive especificado no arquivo de configuração do agentd.

-I, --source-address IP-address
Especifica o endereço IP de origem. Quando usado junto com --config, sobrescreve o parâmetro SourceIP especificado no arquivo de configuração do agentd.

-t, --timeout seconds
Especifica o timeout. 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 frontend do Zabbix). O endereço IP do host e o nome DNS não funcionarão. Quando usado junto com --config, sobrescreve o parâmetro Hostname especificado no arquivo de configuração do agentd.

-k, --key key
Especifica a chave do item para enviar o valor.

-o, --value value
Especifica o valor do item.

-i, --input-file input-file
Carrega valores de um arquivo de entrada. Especifique - como <input-file> para ler valores da entrada padrão. Cada linha do arquivo contém, separados por espaço: <hostname> <key> <value>. Cada valor deve ser especificado em sua própria linha. Cada linha deve conter 3 entradas separadas por espaço: <hostname> <key> <value>, onde "hostname" é o nome do host monitorado conforme registrado no frontend do Zabbix, "key" é a chave do item de destino e "value" - o valor a ser enviado. Especifique - como <hostname> para usar o hostname do arquivo de configuração do agent ou do argumento --host.

Um exemplo de linha de um arquivo de entrada:

"Linux DB3" db.connections 43

O tipo de valor deve ser corretamente definido na configuração do item no frontend do Zabbix. O Zabbix sender enviará até 250 valores em uma conexão. O limite de tamanho para 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. As entradas devem ser formatadas usando as seguintes regras:

Entradas entre aspas e sem aspas são suportadas.
Aspas duplas são o caractere de citação.
Entradas com espaço devem ser citadas.
Aspas duplas e barras invertidas dentro de uma entrada citada devem ser escapadas com uma barra invertida.
Escape não é suportado em entradas sem aspas.
Sequências de escape de quebra de linha (\n) são suportadas em strings citadas.
Sequências de escape de quebra de linha são removidas 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 separadas por espaço: <hostname> <key> <timestamp> <value>. O timestamp deve ser especificado no formato de timestamp Unix. Se o item de destino tiver triggers referenciando-o, todos os timestamps devem estar em ordem crescente, caso contrário o cálculo do evento não será correto.

Um exemplo de linha do arquivo de entrada:

"Linux DB3" db.connections 1429533600 43

Para mais detalhes, consulte a opção --input-file.

Se um valor com timestamp for enviado para um host que está em um tipo de manutenção “sem dados”, esse valor será descartado; no entanto, é possível enviar um valor com timestamp para um período de manutenção expirado e ele 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 separadas por espaço: <hostname> <key> <timestamp> <ns> <value>.

Um exemplo de linha do arquivo de entrada:

"Linux DB3" db.connections 1429533600 7402561 43

Para mais detalhes, consulte a opção --input-file.

-r, --real-time
Envia valores um por um assim que são recebidos. Isso pode ser usado ao ler da entrada padrão.

-g, --group
Agrupa valores por hosts e envia para cada host em um lote separado.

--tls-connect value
Como conectar ao server ou proxy. Valores:

unencrypted
conectar sem criptografia (padrão)

psk
conectar usando TLS e uma chave pré-compartilhada

cert
conectar usando TLS e um certificado

--tls-ca-file CA-file
Caminho completo para um arquivo contendo o(s) certificado(s) da(s) CA(s) de nível superior para verificação do certificado do par.

--tls-crl-file CRL-file
Caminho completo para um arquivo contendo certificados revogados.

--tls-server-cert-issuer cert-issuer
Emissor de certificado de server permitido.

--tls-server-cert-subject cert-subject
Assunto de certificado de server permitido.

--tls-cert-file cert-file
Caminho completo para um arquivo contendo o certificado ou cadeia de certificados.

--tls-key-file key-file
Caminho completo para um arquivo contendo a chave privada.

--tls-psk-identity PSK-identity
String de identidade PSK.

--tls-psk-file PSK-file
Caminho completo para um arquivo contendo a chave pré-compartilhada.

--tls-cipher13 cipher-string
String de cifra para OpenSSL 1.1.1 ou mais recente para TLS 1.3. Substitui os critérios padrão de seleção de ciphersuite. Esta opção não está disponível se a versão do OpenSSL for menor que 1.1.1.

--tls-cipher cipher-string
String de prioridade GnuTLS (para TLS 1.2 e superior) ou string de cifra OpenSSL (apenas para TLS 1.2). Substitui os critérios padrão de seleção de ciphersuite.

-v, --verbose
Modo detalhado, -vv para mais detalhes.

-h, --help
Exibe esta ajuda e sai.

-V, --version
Exibe informações da versão e sai.

STATUS DE SAÍDA

O status de saída é 0 se os valores foram enviados e todos foram processados com sucesso pelo server. Se os dados foram enviados, mas o processamento de pelo menos um dos valores falhou, o status de saída é 2. Se o envio dos dados falhar, o status de saída é 1.

EXEMPLOS

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45

Envia 342.45 como valor para o item mysql.queries do host monitorado. Usa o host monitorado e o Zabbix server definidos no arquivo de configuração do agent.

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45

Envia 342.45 como valor para o item mysql.queries do host Monitored Host usando o Zabbix server definido no arquivo de configuração do agent.

zabbix_sender -z 192.168.1.113 -i data_values.txt

Envia valores do arquivo data_values.txt para o Zabbix server com o IP 192.168.1.113. Os nomes dos hosts e as keys são definidos no arquivo.

echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c /usr/local/etc/zabbix_agentd.conf -T -i -

Envia um valor com timestamp da linha de comando para o Zabbix server, especificado no arquivo de configuração do agent. O traço nos dados de entrada indica que o hostname também deve ser usado do mesmo arquivo de configuração.

echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

Envia um valor vazio de um item para o Zabbix server com endereço IP 192.168.1.113 na porta 10000 a partir da linha de comando. Valores vazios devem ser indicados 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

Envia 342.45 como valor para o item mysql.queries no host Monitored Host para o server 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

Envia 342.45 como valor para o item mysql.queries no host Monitored Host para o server com IP 192.168.1.113 usando TLS com chave pré-compartilhada (PSK).