12 Itens trapper

Visão geral

Itens trapper aceitam dados recebidos em vez de consultá-los. Isso é útil para qualquer dado que você queira enviar ao Zabbix.

Configuração

Para configurar um item trapper:

1. Vá para Coleta de dados → Hosts.
2. Clique em Itens na linha do host.
3. Clique em Criar item.
4. Insira os parâmetros do item no formulário de configuração.

Todos os campos obrigatórios estão marcados com um asterisco vermelho.

Os campos que exigem informações específicas para itens trapper são:

Enviando dados

O envio de dados para o Zabbix server ou proxy é possível usando a ferramenta Zabbix sender ou o protocolo do Zabbix sender. O envio de dados para o Zabbix server também é possível usando o método de API history.push.

Zabbix sender

Para enviar dados para o Zabbix server ou proxy usando o utilitário Zabbix sender, você pode executar o seguinte comando para enviar o "test value":

zabbix_sender -z <endereço IP do server> -p 10051 -s "New host" -k trap -o "test value"

Para enviar o "test value", as seguintes opções de comando são usadas:

• -z para especificar o endereço IP do Zabbix server
• -p para especificar o número da porta do Zabbix server (10051 por padrão)
• -s para especificar o host (certifique-se de usar o nome técnico em vez do nome visível do host)
• -k para especificar a chave do item configurado no item trapper
• -o para especificar o valor a ser enviado

Para mais informações sobre a comunicação entre o Zabbix sender e o Zabbix server ou proxy, consulte Protocolo do Zabbix sender.

history.push

Para enviar dados ao Zabbix server usando o método de API history.push, você pode fazer a seguinte solicitação HTTP POST contendo alguns valores de teste:

curl --request POST \
         --url 'https://example.com/zabbix/api_jsonrpc.php' \
         --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \
         --header 'Content-Type: application/json-rpc' \
         --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}'

Se a solicitação estiver correta, a resposta retornada pela API pode ser semelhante a:

{
           "jsonrpc": "2.0",
           "result": {
               "response": "success",
               "data": [
                   {
                       "itemid": "10600"
                   },
                   {
                       "itemid": "10601",
                       "error": "Item is disabled."
                   },
                   {
                       "error": "No permissions to referred object or it does not exist."
                   }
               ]
           },
           "id": 1
       }

Os erros nos dados de resposta indicam que o envio de dados para itens específicos falhou na validação pelo Zabbix server. Isso pode acontecer pelos seguintes motivos:

• o usuário que está enviando os dados não tem permissão de leitura para o host do item;
• o host está desabilitado ou em manutenção sem coleta de dados;
• o item não existe ou ainda não está incluído no cache de configuração do server;
• o item está desabilitado ou seu tipo é diferente de Zabbix trapper ou HTTP agent (com trapping habilitado);
• o IP ou DNS do usuário não está definido na lista de Allowed hosts do item;
• outro item possui um valor com timestamp duplicado no nível de nanossegundos.

A ausência de erros indica que os valores enviados foram aceitos para processamento, o que inclui pré-processamento (se houver), processamento de trigger e salvamento no banco de dados. Observe que o processamento de um valor aceito também pode falhar (por exemplo, durante o pré-processamento), resultando no descarte do valor.

Para mais informações sobre como trabalhar com a API do Zabbix, consulte API.

Exibindo dados

Depois que os dados são enviados, você pode navegar até Monitoramento → Últimos dados para ver o resultado: