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 [ ]{#lbAD}

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. [ ]{#lbAE}

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 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 o envio de dados. Se o envio de dados em lote falhar para um endereço, os lotes seguintes não serão enviados para este 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 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. Faixa válida: 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). Endereço IP do host e 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.

Exemplo de uma 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 aspas.
Entradas com espaço devem ser colocadas entre aspas.
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ço: <hostname> <key> <timestamp> <value>. O timestamp deve ser especificado no formato Unix timestamp. 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.

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

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

[ ]{#lbAF}

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.

[ ]{#lbAG}

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.

[ ]{#lbAH}

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

[ ]{#lbAI}