Nesta página
zabbix_sender
ZABBIX_SENDER(1) Manual Geral de Comandos 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 Zabbix server ou proxy. No Zabbix server, deve ser
criado um item do tipo Zabbix trapper com a key correspondente. Observe
que os valores recebidos serão aceitos apenas de hosts especificados no
campo Allowed hosts para este item.
OPÇÕES
-c, --config config-file
Usar config-file. O Zabbix sender lê os detalhes do server do
arquivo de configuração do agentd. Por padrão, o Zabbix sender
não lê nenhum arquivo de configuração. Somente os parâmetros
Hostname, Server‐Active, SourceIP, TLSConnect, TLSCAFile,
TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile,
TLSKey‐File, TLSPSKIdentity e TLSPSKFile são suportados. O
Hostname definido pelo parâmetro HostnameItem não será obtido;
nesse caso, o nome do host deve ser especificado pela linha de
comando (consulte 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 um lote de dados 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 Zabbix server. Se um host for
monitorado por um proxy, o nome do host ou endereço IP do proxy
deverá ser usado em vez disso. 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 server 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 Zabbix frontend). Endereço IP e nome DNS do host
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 do arquivo de entrada. Especifique - como
<input-file> para ler valores da entrada padrão. Cada linha do
arquivo contém, separados por espaços em branco:
<hostname> <key> <value>. Cada valor deve ser especificado em sua
própria linha. Cada linha deve conter 3 entradas separadas por
espaços em branco: <hostname> <key> <value>, em que "hostname" é
o nome do host monitorado conforme registrado no Zabbix frontend,
"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.
Um exemplo de 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 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. 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ços em branco devem estar entre aspas.
• Os caracteres de aspas duplas e barra invertida dentro
de uma entrada entre aspas devem ser escapados 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ços em branco:
<hostname> <key> <timestamp> <value>. O timestamp deve ser
especificado no formato de timestamp Unix. Se o item de destino
tiver triggers que façam referência a ele, todos os timestamps
devem estar em ordem crescente; caso contrário, o cálculo de
eventos não estará 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 esteja 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ços em branco:
<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.
--tls-connect value
Como se 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 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 permitido do certificado do server.
--tls-server-cert-subject cert-subject
Assunto permitido do certificado do server.
--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 PSK.
--tls-psk-file PSK-file
Caminho completo de um arquivo que contém a chave pré-
compartilhada.
--tls-cipher13 cipher-string
String de cifras 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
inferior a 1.1.1.
--tls-cipher cipher-string
String de prioridade do GnuTLS (para TLS 1.2 e superior) ou
string de cifras do OpenSSL (somente para TLS 1.2). Substitui os
critérios padrão de seleção do conjunto de cifras.
-v, --verbose
Modo detalhado, -vv para mais detalhes.
-h, --help
Exibe esta ajuda e sai.
-V, --version
Exibe informações de 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 dos 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 o 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 o 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
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 Zabbix
server, 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 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 o 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 o 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).
VEJA TAMBÉM
Documentation
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)