Nesta página
zabbix_sender
ZABBIX_SENDER(1) Manual de Comandos Gerais ZABBIX_SENDER(1)
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] -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] -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-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher 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-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher 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 server ou proxy do Zabbix. No server do Zabbix,
deve ser criado um item do tipo Zabbix trapper com a key 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 o 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 por meio do parâmetro HostnameItem
não será considerado; nesse caso, o hostname deve ser especificado
pela 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 envio de dados. Se o envio de dados em lote falhar
para um endereço, os lotes seguintes não serão enviados para esse
endereço.
-z, --zabbix-server server
Nome do host ou endereço IP do server do Zabbix. Se um host for
monitorado por um proxy, deve ser usado o nome do host ou o
endereço IP do proxy. Quando usado junto com --config, substitui
as entradas do parâmetro ServerActive especificadas no arquivo de
configuração do agentd.
-p, --port port
Especifica o número da porta do Zabbix trapper em execução no
server. O padrão é 10051. Quando usado junto com --config,
substitui as entradas de porta do parâmetro ServerActive
especificadas no arquivo de configuração do 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 do 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 frontend do Zabbix). 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
agentd.
-k, --key key
Especifica a key do item para a qual 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 em branco: <hostname> <key>
<value>. Cada valor deve ser especificado em sua própria linha.
Cada linha deve conter 3 entradas separadas por espaço em branco:
<hostname> <key> <value>, em que "hostname" é o nome do host
monitorado, conforme registrado no frontend do Zabbix, "key" é a
key 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.
Exemplo de uma linha de um arquivo de entrada:
"Linux DB3" db.connections 43
O tipo de valor deve estar corretamente definido na configuração
do item no frontend do Zabbix. O Zabbix sender enviará até 250
valores em uma conexão. O conteúdo do arquivo de entrada deve
estar em 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 em branco devem estar entre aspas.
• Aspas duplas e barras invertidas dentro de uma entrada
entre aspas 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 entre aspas.
• 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 em branco: <hostname> <key> <timestamp>
<value>. O timestamp deve ser especificado no formato de
timestamp Unix. Se o item de destino tiver triggers que o
referenciem, todos os timestamps devem estar em ordem crescente;
caso contrário, o cálculo do evento não será correto.
Exemplo de uma 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 esteja em
um tipo de manutenção “no data”, 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 em branco: <hostname> <key> <timestamp> <ns>
<value>.
Exemplo de uma 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 os valores um a um assim que são recebidos. Isso pode ser
usado ao ler da entrada padrão.
--tls-connect value
Como se conectar ao server ou proxy. Valores:
unencrypted
conecta sem criptografia (padrão)
psk conecta usando TLS e uma chave pré-compartilhada
cert conecta usando TLS e um certificado
--tls-ca-file CA-file
Caminho completo de um arquivo que contém os certificados da(s)
CA(s) de nível superior para verificação do certificado do par.
--tls-crl-file CRL-file
Caminho completo de um arquivo que contém certificados revogados.
--tls-server-cert-issuer cert-issuer
Emissor do certificado do server permitido.
--tls-server-cert-subject cert-subject
Subject do certificado do server permitido.
--tls-cert-file cert-file
Caminho completo de um arquivo que contém o certificado ou a
cadeia de certificados.
--tls-key-file key-file
Caminho completo de um arquivo que contém a chave privada.
--tls-psk-identity PSK-identity
String de identidade do PSK.
--tls-psk-file PSK-file
Caminho completo de um arquivo que contém 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 do conjunto de cifras.
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 do GnuTLS (para TLS 1.2 e superior) ou
string de cifra do OpenSSL (somente para TLS 1.2). Substitui os
critérios padrão de seleção do conjunto de cifras.
-v, --verbose
Modo verboso, -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 eles 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 de dados falhou, 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 do item mysql.queries do host monitorado.
Usa o host monitorado e o server do Zabbix 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 do item mysql.queries do host Monitored
Host usando o server do Zabbix 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 server do Zabbix
com IP 192.168.1.113. Os nomes de host 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 server do
Zabbix, especificado no arquivo de configuração do agent. O
hífen nos dados de entrada indica que o hostname também deve ser
usado a partir 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 server do Zabbix 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 do 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 do item mysql.queries no host Monitored
Host para o server com IP 192.168.1.113 usando TLS com chave
pré-compartilhada (PSK).
VEJA TAMBÉM
Documentação
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8),
zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)
Zabbix 2022-01-06 ZABBIX_SENDER(1)