zabbix_sender

Seção: comandos de manutenção (8)
Atualizado: 10 de novembro de 2011
Índice Retornar ao conteúdo principal

NOME

zabbix_sender - utilitário Zabbix sender.

SINOPSE

zabbix_sender [-hpzvIV] {-kso | [-T] -i <arquivo-de-entrada>} [-c <arquivo-de-configuração>]

DESCRIÇÃO

zabbix_sender é um utlitário de linha de comando para envio de dados para um servidor Zabbix remoto. No servidor Zabbix um item de tipo Zabbix trapper deve ser criado com correspondente chave. Note que valores só serão aceitos pelo server se vindos de hosts especificados no campo Hosts permitidos para este item.

Optções

-c, --config <arquivo-de-configuração>
Usa o arquivo-de-configuração. O Zabbix sender lê detalhes sobre o servidor do arquivo de configuração do agente. Por padrão o Zabbix sender não lê nenhum arquivo de configuração. Deve ser especificado um caminho absoluto. Somente os parâmetros Hostname, ServerActive and SourceIP são suportados. A primeira entrada do parâmetro ServerActive é usada.

-z, --zabbix-server <servidor>
Hostname ou endereço IP do servidor Zabbix. Se um host é monitorado por proxy, o hostname ou endereço IP do proxy deve ser usado.

-p, --port <porta>
Especifica a porta do servidor trapper rodando no server. O padrão é 10051.

-s, --host <host>
Especifica o hostname tal como registrado no frontend Zabbix. O endereço IP do host e nome DNS não vão funcionar.

-I, --source-address <IP>
Especifica o endereço IP de origem.

-k, --key <chave>
Especifica a chave de item para a qual enviar o valor.

-o, --value <valor>
Especifica o valor.

-i, --input-file <arquivo-de-entrada>
Carrega valores de um arquivo. Especificar - para entrada padrão (standard input). Cada linha do arquivo contém os seguintes campos, delimitados por espaço em branco: <hostname> <chave> <valor>. Especificar - no <hostname> para usar hostname do arquivo de configuração, ou então o argumento --host. Todas as entradas são enviadas em ordem sequencial, top-down.

-T, --with-timestamps
Cada linha do arquivo contém os seguintes campos, delimitados por espaço em branco: <hostname> <key> <timestamp> <valor>. Pode ser usado com a opção --input-file. Timestamp deve ser especificano formato Unix timestamp. Se o item alvo tem triggers fazendo referência a ele, todos os timestamps devem estar em ordem crescente. do contrário o cálculo de eventos não funcionará corretamente.

-r, --real-time
Enviar valores um por um assim que forem recebidos. Pode ser usado quando lendo da entrada padrão (standard input).

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

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

-V, --version
Apresenta informações sobre a versão e sai.

STATUS DE SAÍDA

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

EXEMPLOS

zabbix_sender -c /usr/local/etc/zabbix_agentd.conf -s host monitorado -k mysql.queries -o 342.45

Envia 342.45 como o valor para a chave mysql.queries em host monitorado usando o servidor Zabbix definido no arquivo de configuração do agente.

zabbix_sender -z 192.168.1.113 -i data_values.txt

Envia valores lidos do arquivo data_values.txt para o servidor com IP 192.168.1.113. Hostnames e chaves 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 pela linha de comando para o servidor Zabbix especificado no arquivo de configuração do agente. Um traço (dash, "-") nos dados de entrada indica que o hostname a ser utilizado também deve ser lido do arquivo de configuração.