3 Protocolo do agente Zabbix 2

Visão geral

Esta seção fornece informações sobre:

  • Agent2 -> Server : ativar solicitação de verificações

  • Server -> Agent2 : ativar resposta de verificações

  • Agent2 -> Server : solicitação de dados do agente

  • Server -> Agent2 : resposta de dados do agente

Solicitação de verificações ativas

A solicitação de verificações ativas é usada para obter as verificações ativas a serem processadas pelo agente. Esta solicitação é enviada pelo agente ao iniciar e, em seguida, em intervalos com RefreshActiveChecks.

Campo Tipo Obrigatório Valor
request string sim active checks
host string sim Nome host.
version string sim Versão do agente: <major>.<minor>.
host_metadata string não Parâmetro de configuração HostMetadata ou HostMetadataItem valor métrico.
interface string não Parâmetro de configuração HostInterface ou HostInterfaceItem valor métrico.
ip string não Parâmetro de configuração ListenIP first IP se configurado.
port number não Parâmetro de configuração valor ListenPort se configurado and não agente padrão listening port.

Exemplo:

{
         "request": "active checks",
         "host": "Zabbix server",
         "version": "6.0",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050
       }

Respostas das verificações ativas

A resposta das verificações ativas é enviada pelo servidor de volta ao agente depois de processar a solitação de verificações ativas.

Campo Tipo Obrigatório Valor
response string sim success | failed
info string não Informações de erro no caso de falha.
data array of objects não Itens de verificação ativa.
key string não Item key com macros expandidas.
itemid number não Identificador do item.
delay string não Intervalo de atualização do item.
lastlogsize number não Item lastlogsize.
mtime number não Item mtime.
regexp array of objects não Global regular expressions.
name string não Global regular expression name.
expression string não Expressão regular global.
expression_type number não Tipo Expressão regular global.
exp_delimiter string não Delimitador Expressão regular global.
case_sensitive number não Configuração de sensibilidade a maiúsculas/minúsculas para expressão regular global.

Exemplo:

{
         "response": "success",
         "data": [
           {
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "itemid": 1234,
             "delay": "30s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "itemid": 5678,
             "delay": "10m",
             "lastlogsize": 0,
             "mtime": 0
           }
         ]
       }

Solicitação de dados do agente

A solicitação de dados do agente contém valores dos itens coletados.

Field Tipo Obrigatório Valor
request string sim agent data
host string sim Nome do Host.
version string sim A versão do agente: <maior>.<memnor>.
session string sim O identificador de sessão único é geradado cada vez que um agente é iniciado.
data array de objetos sim Valores de itens.
id número sim Identificador de valor (contador incremental usado para verificar valores duplicados no caso de problemas de rede).
itemid número sim Identificador de item.
value string não O valor de item.
lastlogsize número não O item lastlogsize.
mtime número não O item mtime.
state número não O status do item.
source string não O valor do evento de origem do registro.
eventid número não O valor do ID do registro de eventos.
severity número não O valor da severidade do registro de eventos.
timestamp número não O valor do carimbo de data/hora do registro de eventos.
clock número sim O valor do carimbo de data/hora (segundos desde Epoch).
ns número sim O valor do carimbo de data/hora em nanosegundos.

Exemplo:

{
         "request": "agent data",
         "data": [
           {
             "id": 1,
             "itemid": 5678,
             "value": "2.4.0",
             "clock": 1400675595,
             "ns": 76808644
           },
           {
             "id": 2,
             "itemid": 1234,
             "lastlogsize": 112,
             "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
             "clock": 1400675595,
             "ns": 77053975
           }
         ],
         "host": "Zabbix server",
         "version": "6.0",
         "session": "1234456akdsjhfoui"
       }

Resposta de dados do agente

A resposta de dados do agente é enviada pelo servidor de volta para o agente após o processamento de solicitação de dados do agente.

Field Tipo Obrigatório Valor
response string sim success | failed
info string sim Resultados do processamento do item.

Exemplo:

{
         "response": "success",
         "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
       }