Zabbix Documentation 5.0

Esta seção fornece detalhes sobre as verificações passivas e ativas utilizando o Zabbix Agent.

O Zabbix utiliza o protocolo JSON para se comunicar com o Zabbix Agent.

Existem algumas definições detalhadas nos protocolos utilizados pelo Zabbix:

<HEADER> - "ZBXD\x01" (5 bytes)
<DATALEN> - tamanho do dado (8 bytes). 1 será formatado como 01/00/00/00/00/00/00/00 (oito bytes em HEX, número de 64 bit)

Para evitar o potencial esgotamento de memória o Zabbix Server é limitado a aceitar no máximo 128MB em uma mesma conexão através do protocolo.

Uma verificação passiva é uma requisição simples de dados. O Zabbix Server/Proxy solicita algum dado (por exemplo a carga de CPU) e o Zabbix Agent retorna com o resultado.

Requisição do servidor

<item key>\n

Resposta do agente

<HEADER><DATALEN><DATA>[\0<ERROR>]

No exemplo de resposta acima, a parte enviada entre colchetes é opcional e só é enviada para itens (chaves) não suportadas.

Exemplo de fluxo com item suportado:

1. Servidor abre uma conexão TCP
2. Servidor envia agent.ping\n
3. Agente lê a requisição e responde com <HEADER><DATALEN>1
4. Servidor processa o dado para receber o valor ('1' neste exemplo)
5. Conexão TCP é fechada

Exemplo de fluxo para item não suportado:

1. Servidor abre uma conexão TCP
2. Servidor envia vfs.fs.size[/nono]\n
3. Agente lê a requisição e responde com <HEADER><DATALEN>ZBX_NOTSUPPORTED\0Cannot obtain filesystem information: [2] No such file or directory
4. Servidor processa o dado, modifica o estado do item para 'não suportado' com a mensagem de erro retornada
5. Conexão TCP é fechada

As verificações ativas requerem um processamento mais complexo. Primeiramente o agente deve obter do servidor a lista com os itens a serem processados de forma independente.

Os servidores que irão fornecer a lista de verificações ativas deverão estar listados no parâmetro 'ServerActive' do arquivo de configuração do agente. A frequência de consulta à estas verificações é definida pelo parâmetro 'RefreshActiveChecks' neste mesmo arquivo. Caso uma requisição da lista de itens ativos falhe, uma nova tentativa será feita a cada 60 segundos com aquele servidor.

O agente envia os dados periodicamente aos servidores.

Requisição do agente

<HEADER><DATALEN>{
    "request":"active checks",
    "host":"<hostname>"
}

Resposta do servidor

<HEADER><DATALEN>{
    "response":"success",
    "data":[
        {
            "key":"log[/home/zabbix/logs/zabbix_agentd.log]",
            "delay":30,
            "lastlogsize":0,
            "mtime":0
        },
        {
            "key":"agent.version",
            "delay":600,
            "lastlogsize":0,
            "mtime":0
        },
        {
            "key":"vfs.fs.size[/nono]",
            "delay":600,
            "lastlogsize":0,
            "mtime":0
        }
    ]
}

O servidor deve responder com sucesso. Para cada item retornado todas as propriedades (key, delay, lastlogsize e mtime) deverão estar presentes, mesmo que o item não seja de log.

Exemplo do fluxo:

1. Agente abre uma conexão TCP
2. Agente requisita a lista de verificações ativas
3. Servidor responde com uma lista de itens (item key, delay, lastlogsize e mtime)
4. Agente processa a resposta
5. Conexão TCP é fechada
6. O agente coleta de forma periódica os dados

O agente envia os dados

<HEADER><DATALEN>{
    "request":"agent data",
    "data":[
        {
            "host":"<hostname>",
            "key":"agent.version",
            "value":"2.4.0",
            "clock":1400675595,            
            "ns":76808644
        },
        {
            "host":"<hostname>",
            "key":"log[/home/zabbix/logs/zabbix_agentd.log]",
            "lastlogsize":112,
            "value":" 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
            "clock":1400675595,            
            "ns":77053975
        },
        {
            "host":"<hostname>",
            "key":"vfs.fs.size[/nono]",
            "state":1,
            "value":"Cannot obtain filesystem information: [2] No such file or directory",
            "clock":1400675595,            
            "ns":78154128
        }
    ],
    "clock": 1400675595,
    "ns": 78211329
}

O servidor responde

<HEADER><DATALEN>{
    "response":"success",
    "info":"processed: 3; failed: 0; total: 3; seconds spent: 0.003534"
}

Exemplo de fluxo:

1. O agente abre a conexão TCP
2. O agente envia a lista de valores
3. O servidor processa os dados e envia o status de volta
4. A conexão TCP é fechada

Observe no exemplo acima que o status de não suportado para a chave vfs.fs.size[/nono] é indicado pela propriedade “state” tendo o valor '1' e a mensagem de erro vai na propriedade “value”.

1. Mais detalhes sobre o protocolo do Zabbix Agent (inglês)