8 Verificações internas

Visão geral

As verificações internas permitem monitorar os processos internos do Zabbix. Em outras palavras, você pode monitorar o que acontece com o Zabbix server ou o Zabbix proxy.

As verificações internas são calculadas:

• no Zabbix server - se o host for monitorado pelo server
• no Zabbix proxy - se o host for monitorado pelo proxy

As verificações internas são processadas pelo server ou proxy independentemente do status de manutenção do host.

Para usar este item, escolha o tipo de item Zabbix internal.

Desempenho

O uso de alguns itens internos pode afetar negativamente o desempenho. Esses itens são:

• zabbix[host,,items]
• zabbix[host,,items_unsupported]
• zabbix[hosts]
• zabbix[items]
• zabbix[items_unsupported]
• zabbix[queue,,]
• zabbix[requiredperformance]
• zabbix[stats,,,queue,,]
• zabbix[triggers]

As seções do frontend Informações do sistema e Fila também são afetadas.

Verificações suportadas

As chaves de item são listadas sem parâmetros personalizáveis e informações adicionais. Clique na chave do item para ver todos os detalhes.

Detalhes da chave do item

• Parâmetros sem colchetes angulares são obrigatórios e devem ser usados como estão (por exemplo, "host" e "available" em zabbix[host,<type>,available]).
• Parâmetros com colchetes angulares < > devem ser substituídos por um valor válido. Se um parâmetro tiver um valor padrão, ele pode ser omitido.
• Valores para items e parâmetros de item rotulados como "não suportado em proxy" só podem ser coletados se o host for monitorado pelo server. Da mesma forma, valores "não suportados no server" só podem ser coletados se o host for monitorado pelo proxy.

zabbix[boottime]

O tempo de inicialização do processo do Zabbix server ou do Zabbix proxy em segundos.
Valor de retorno: Integer.

zabbix[cluster,discovery,nodes]

Descobre os nós do cluster de alta disponibilidade.
Valor de retorno: objeto JSON.

Comentários:

• Este item pode ser usado em descoberta de baixo nível.

zabbix[connector_queue]

A contagem de valores enfileirados na fila do conector.
Valor de retorno: Inteiro.

zabbix[discovery_queue]

A contagem de verificações de rede enfileiradas na fila de descoberta.
Valor de retorno: Inteiro.

zabbix[host,,items]

O número de items habilitados (suportados e não suportados) no host.
Valor de retorno: Integer.

zabbix[host,,items_unsupported]

O número de items habilitados e não suportados no host.
Valor de retorno: Inteiro.

zabbix[host,,maintenance]

O status de manutenção atual do host.
Valores de retorno: 0 - estado normal; 1 - manutenção com coleta de dados; 2 - manutenção sem coleta de dados.

Comentários:

• Este item é sempre processado pelo Zabbix server, independentemente da localização do host (no server ou proxy). O proxy não receberá este item com dados de configuração.
• O segundo parâmetro deve estar vazio e é reservado para uso futuro.

zabbix[host,active_agent,available]

A disponibilidade de verificações de agent ativo no host.
Valores de retorno: 0 - desconhecido; 1 - disponível; 2 - não disponível.

zabbix[host,discovery,interfaces]

Os detalhes de todas as interfaces configuradas do host no frontend do Zabbix.
Valor de retorno: objeto JSON.

Comentários:

• Este item pode ser usado na descoberta de baixo nível.
• Este item não é suportado no proxy Zabbix.

zabbix[host,<type>,available]

A disponibilidade da interface principal de um determinado tipo de checagem no host.
Valores de retorno: 0 - não disponível; 1 - disponível; 2 - desconhecido.

Parâmetros:

• type - agent, snmp, ipmi ou jmx.

Comentários:

• O valor do item é calculado de acordo com os parâmetros de configuração relacionados à inacessibilidade/indisponibilidade do host.

zabbix[hosts]

O número de hosts monitorados.
Valor de retorno: Inteiro.

zabbix[items]

O número de items habilitados (suportados e não suportados).
Valor de retorno: Inteiro.

zabbix[items_unsupported]

O número de items não suportados.
Valor de retorno: Integer.

zabbix[java,,<param>]

Informações sobre o Zabbix Java gateway.
Valores de retorno: 1 - se <param> for ping; versão do Java gateway - se <param> for version (por exemplo: "8.0.0").

Parâmetros:

• param - ping ou version.

Comentários:

• Este item pode ser usado para verificar a disponibilidade do Java gateway usando a função de trigger nodata().
• O segundo parâmetro deve estar vazio e é reservado para uso futuro.

zabbix[lld_queue]

A contagem de valores enfileirados na fila de processamento de descoberta de baixo nível.
Valor de retorno: Inteiro.

Comentários:

• Este item pode ser usado para monitorar o comprimento da fila de processamento de descoberta de baixo nível.

zabbix[preprocessing]

Estatísticas dos valores recebidos pelo gerenciador de pré-processamento:
- queued - o número e o tamanho dos valores em fila que requerem pré-processamento (contador)
- direct - o número e o tamanho dos valores em fila que não requerem pré-processamento (contador)
- queue - a contagem de valores enfileirados na fila de pré-processamento (igual a zabbix[preprocessing_queue])
Valor de retorno: JSON.

Exemplo de valores de retorno:

{"data":
           {
           "queued": {
               "count": 106,
               "size": 58620
           },
           "direct": {
               "count": 395,
               "size": 33843
           },
           "queue": 0
           }
       }

zabbix[preprocessing_queue]

A contagem de valores enfileirados na fila de pré-processamento.
Valor de retorno: Integer.

Comentários:

• Este item pode ser usado para monitorar o comprimento da fila de pré-processamento.

zabbix[process,<type>,<mode>,<state>]

A porcentagem de tempo que um determinado processo do Zabbix ou um grupo de processos (identificados por <type> e <mode>) passou no <state>. É calculado apenas para o último minuto.
Valor de retorno: Float.

Parâmetros:

• type - para processos do server: agent poller, alert manager, alert syncer, alerter, availability manager, browser poller, configuration syncer, configuration syncer worker, connector manager, connector worker, discovery manager, discovery worker, escalator, ha manager, history poller, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller ipmi manager, ipmi poller, java poller, lld manager, lld worker, odbc poller, poller, preprocessing manager, preprocessing worker, proxy group manager, proxy poller, self-monitoring, service manager, snmp poller, snmp trapper, task manager, timer, trapper, trigger housekeeper, unreachable poller, vmware collector;
  para processos do proxy: agent poller, availability manager, browser poller, configuration syncer, data sender, discovery manager, discovery worker, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller ipmi manager, ipmi poller, java poller, odbc poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp poller, snmp trapper, task manager, trapper, unreachable poller, vmware collector;
• mode - avg - valor médio para todos os processos de um determinado tipo (padrão);
  count - retorna o número de forks para um determinado tipo de processo, <state> não deve ser especificado;
  max - valor máximo;
  min - valor mínimo;
  <process number> - número do processo (entre 1 e o número de instâncias pré-forked; por exemplo, se 4 trappers estiverem em execução, o valor estará entre 1 e 4);
• state - busy - o processo está em estado ocupado, por exemplo, processando uma requisição (padrão);
  idle - o processo está em estado ocioso, sem fazer nada.

Comentários:

• Se <mode> for um número de processo do Zabbix que não está em execução (por exemplo, com 5 pollers em execução, o <mode> for especificado como 6), tal item ficará como não suportado.
• Mínimo e máximo referem-se à porcentagem de uso para um único processo. Portanto, se em um grupo de 3 pollers as porcentagens de uso por processo forem 2, 18 e 66, min retornará 2 e max retornará 66.
• Os processos relatam o que estão fazendo na memória compartilhada e o processo de auto-monitoramento resume esses dados a cada segundo. Mudanças de estado (busy/idle) são registradas na mudança - assim, um processo que se torna ocupado é registrado como tal e não muda ou atualiza o estado até que se torne ocioso. Isso garante que mesmo processos totalmente travados sejam corretamente registrados como 100% ocupados.
• Atualmente, "busy" significa "não dormindo", mas no futuro estados adicionais podem ser introduzidos - aguardando locks, realizando consultas ao banco de dados, etc. Observe que pollers assíncronos são considerados ocupados se atingirem o limite definido pelo parâmetro de configuração MaxConcurrentChecksPerPoller do server/proxy.
• No Linux e na maioria dos outros sistemas, a resolução é de 1/100 de segundo.

Exemplos:

zabbix[process,poller,avg,busy] #tempo médio dos processos poller fazendo algo durante o último minuto
       zabbix[process,"icmp pinger",max,busy] #tempo máximo gasto fazendo algo por qualquer processo ICMP pinger durante o último minuto
       zabbix[process,"history syncer",2,busy] #tempo gasto fazendo algo pelo history syncer número 2 durante o último minuto
       zabbix[process,trapper,count] #quantidade de processos trapper atualmente em execução

zabbix[proxy,<name>,<param>]

Informações sobre o proxy Zabbix.
Valor de retorno: Integer.

Parâmetros:

• name - o nome do proxy;
• param - lastaccess - o timestamp da última mensagem de heartbeat recebida do proxy;
  delay - quanto tempo os valores coletados estão sem envio; calculado como "proxy delay" + ("current server time" - "proxy lastaccess"), onde "proxy delay" é a diferença entre o tempo atual do proxy e o timestamp do valor não enviado mais antigo no proxy.

Comentários:

• Este item é sempre processado pelo Zabbix server, independentemente da localização do host (no server ou proxy).
• A função fuzzytime() pode ser usada para verificar a disponibilidade do proxy.

Exemplo:

zabbix[proxy,"Germany",lastaccess] #o timestamp da última mensagem de heartbeat recebida do proxy "Germany"

zabbix[proxy,discovery]

A lista de proxies do Zabbix com nome, modo, criptografia, compressão, versão, último visto, contagem de hosts, contagem de items, valores necessários por segundo (vps), status da versão (atual/desatualizada/não suportada), timeouts por tipo de item, nome do grupo do proxy (se o proxy pertence a um grupo), estado (desconhecido/offline/online).
Valor de retorno: objeto JSON.

zabbix[proxy group,<name>,available]

O número de proxies online em um grupo de proxies.
Valor de retorno: Integer.

Parâmetros:

• name - o nome do grupo de proxies.

zabbix[proxy group,<name>,pavailable]

A porcentagem de proxies online em um grupo de proxies.
Valor de retorno: Float.

Parâmetros:

• name - o nome do grupo de proxies.

zabbix[proxy group,<name>,proxies]

A lista de proxies Zabbix em um grupo de proxies com nome, modo, criptografia, compressão, versão, última visualização, contagem de hosts, contagem de items, valores por segundo (vps) necessários, status da versão (atual/desatualizada/não suportada), timeouts, nome do grupo de proxies, estado (desconhecido/offline/online).
Valor de retorno: JSON.

Parâmetros:

• name - o nome do grupo de proxies.

zabbix[proxy group,<name>,state]

O estado de um grupo de proxy.
Valor de retorno: 0 - desconhecido; 1 - offline; 2 - recuperando; 3 - online; 4 - degradando.

Parâmetros:

• name - o nome do grupo de proxy.

zabbix[proxy group,discovery]

Retorna uma lista de grupos de proxy com dados de configuração e dados em tempo real. Os dados de configuração incluem o nome do grupo de proxy, o atraso de failover e o número mínimo de proxies online necessários. Os dados em tempo real incluem o estado do grupo de proxy (veja os comentários para detalhes), o número de proxies online e a porcentagem de proxies online.
Valor de retorno: JSON.

Comentários:

• Este item não retorna proxies sem grupo.
• Se houver um valor inválido para "failover_delay" ou "min_online", então um valor especial -1 é reportado para indicar isso. Valores inválidos podem ocorrer se macros forem usadas para configuração e as macros não puderem ser expandidas para um valor válido.
• O estado do grupo de proxy é reportado como um inteiro: 0 - desconhecido; 1 - offline; 2 - recuperando; 3 - online; 4 - degradando.

Exemplo de valores de retorno:

{
           "groups": [
              { "name": "Riga", "failover_delay": 60, "min_online": 1 },
              { "name": "Tokyo", "failover_delay": 60, "min_online": 2 },
              { "name": "Porto Alegre", "failover_delay": 60, "min_online": 3 }
           ],
           "details": {
               "Riga": { "state": 3, "available": 10, "pavailable": 20 },
               "Tokyo": { "state": 3, "available": 10, "pavailable": 20 },
               "Porto Alegre": { "state": 1, "available": 0, "pavailable": 0 }
           }
       }

zabbix[proxy_buffer,buffer,<mode>]

As estatísticas de uso do buffer de memória do proxy.
Valores de retorno: Integer (para tamanho); Float (para porcentagem).

Parâmetros:

• mode: total - o tamanho total do buffer (pode ser usado para verificar se o buffer de memória está habilitado);
  free - o tamanho do buffer livre;
  pfree - a porcentagem do buffer livre;
  used - o tamanho do buffer usado;
  pused - a porcentagem do buffer usado.

Comentários:

• Retorna um erro 'Proxy memory buffer is disabled' quando o buffer de memória está desabilitado;
  
• Este item não é suportado no Zabbix server.

zabbix[proxy_buffer,state,changes]

Retorna o número de mudanças de estado entre os modos de buffer de disco/memória desde o início.
Valores de retorno: Integer; 0 - o buffer de memória está desabilitado.

Comentários:

• Mudanças frequentes de estado indicam que o tamanho ou a idade do buffer de memória devem ser aumentados.
• Se o estado do buffer de memória for monitorado com pouca frequência (por exemplo, uma vez por minuto), o buffer pode alternar seu estado sem que isso seja registrado.

zabbix[proxy_buffer,state,current]

Retorna o estado de trabalho atual onde os novos dados estão sendo armazenados.
Valores de retorno: 0 - disco; 1 - memória.

Comentários:

• "0" também é retornado quando o buffer de memória está desabilitado.

zabbix[proxy_history]

O número de valores na tabela de histórico do proxy aguardando para serem enviados ao server.
Valores de retorno: Inteiro.

Comentários:

• Este item não é suportado no server Zabbix.

zabbix[queue,<from>,<to>]

O número de items monitorados na fila que estão atrasados pelo menos <from> segundos, mas menos de <to> segundos.
Valor de retorno: Integer.

Parâmetros:

• from - atrasado por pelo menos (o padrão é 6 segundos);
• to - atrasado por no máximo (o padrão é infinito).

Comentários:

• Sufixos de tempo (s,m,h,d,w) são suportados nos parâmetros.

zabbix[rcache,<cache>,<mode>]

As estatísticas de disponibilidade do cache de configuração do Zabbix.
Valores de retorno: Integer (para tamanho); Float (para porcentagem).

Parâmetros:

• cache - buffer;
• mode - total - o tamanho total do buffer;
  free - o tamanho do buffer livre;
  pfree - a porcentagem do buffer livre;
  used - o tamanho do buffer usado;
  pused - a porcentagem do buffer usado.

zabbix[requiredperformance]

O desempenho necessário do Zabbix server ou Zabbix proxy, em novos valores por segundo esperados.
Valor de retorno: Float.

Comentários:

• Correlaciona aproximadamente com "Desempenho necessário do server, novos valores por segundo" em Relatórios → Informações do sistema.

zabbix[stats,<ip>,<port>]

As métricas internas de um Zabbix server ou proxy remoto.
Valores de retorno: objeto JSON.

Parâmetros:

• ip - a lista de IP/DNS/máscara de rede dos servers/proxies a serem consultados remotamente (o padrão é 127.0.0.1);
• port - a porta do server/proxy a ser consultado remotamente (o padrão é 10051).

Comentários:

• A solicitação de stats só será aceita dos endereços listados no parâmetro 'StatsAllowedIP' do server/proxy na instância de destino.
• Um conjunto selecionado de métricas internas é retornado por este item. Para detalhes, veja Monitoramento remoto das estatísticas do Zabbix.

zabbix[stats,<ip>,<port>,queue,<from>,<to>]

As métricas internas da fila (veja zabbix[queue,<from>,<to>]) de um Zabbix server ou proxy remoto.
Valores de retorno: objeto JSON.

Parâmetros:

• ip - a lista de IP/DNS/máscara de rede dos servers/proxies a serem consultados remotamente (padrão é 127.0.0.1);
• port - a porta do server/proxy a ser consultado remotamente (padrão é 10051);
• from - atrasado por pelo menos (padrão é 6 segundos);
• to - atrasado por no máximo (padrão é infinito).

Comentários:

• A solicitação de estatísticas só será aceita dos endereços listados no parâmetro 'StatsAllowedIP' do server/proxy na instância de destino.
• Um conjunto selecionado de métricas internas é retornado por este item. Para detalhes, veja Monitoramento remoto de estatísticas do Zabbix.

zabbix[tcache,<cache>,<parameter>]

As estatísticas de eficácia do cache da função de tendência do Zabbix.
Valores de retorno: Integer (para tamanho); Float (para porcentagem).

Parâmetros:

• cache - buffer;
• parameter - all - solicitações totais de cache (padrão);
  hits - acertos de cache;
  phits - porcentagem de acertos de cache;
  misses - falhas de cache;
  pmisses - porcentagem de falhas de cache;
  items - número de items em cache;
  requests - número de solicitações em cache;
  pitems - porcentagem de items em cache de items em cache + solicitações. Uma porcentagem baixa provavelmente significa que o tamanho do cache pode ser reduzido.

Comentários:

• Este item não é suportado no proxy Zabbix.

zabbix[triggers]

O número de triggers habilitados no banco de dados do Zabbix, com todos os items habilitados em hosts habilitados.
Valor de retorno: Inteiro.

Comentários:

• Este item não é suportado no proxy Zabbix.

zabbix[uptime]

O tempo de atividade do processo do Zabbix server ou proxy em segundos.
Valor de retorno: Integer.

zabbix[vcache,buffer,<mode>]

As estatísticas de disponibilidade do cache de valores do Zabbix.
Valores de retorno: Integer (para tamanho); Float (para porcentagem).

Parâmetros:

• mode - total - o tamanho total do buffer;
  free - o tamanho do buffer livre;
  pfree - a porcentagem do buffer livre;
  used - o tamanho do buffer usado;
  pused - a porcentagem do buffer usado.

Comentários:

• Este item não é suportado no proxy Zabbix.

zabbix[vcache,cache,<parameter>]

As estatísticas de efetividade do cache de valores do Zabbix.
Valores de retorno: Integer. Com o parâmetro mode retorna: 0 - modo normal; 1 - modo de pouca memória.

Parâmetros:

• parameter - requests - o número total de solicitações;
  hits - o número de acertos no cache (valores históricos obtidos do cache);
  misses - o número de falhas no cache (valores históricos obtidos do banco de dados);
  mode - o modo de operação do cache de valores.

Comentários:

• Uma vez que o modo de pouca memória tenha sido ativado, o cache de valores permanecerá neste estado por 24 horas, mesmo que o problema que acionou este modo seja resolvido antes.
• Você pode usar esta chave com a etapa de pré-processamento Change per second para obter estatísticas de valores por segundo.
• Este item não é suportado no Zabbix proxy.

zabbix[version]

A versão do Zabbix server ou proxy.
Valor de retorno: String. Por exemplo: 8.0.0.

zabbix[vmware,buffer,<mode>]

As estatísticas de disponibilidade do cache vmware do Zabbix.
Valores de retorno: Integer (para tamanho); Float (para porcentagem).

Parâmetros:

• mode - total - o tamanho total do buffer;
  free - o tamanho do buffer livre;
  pfree - a porcentagem do buffer livre;
  used - o tamanho do buffer usado;
  pused - a porcentagem do buffer usado.

zabbix[vps,written]

O número total de valores históricos gravados no banco de dados.
Valor de retorno: Inteiro.

zabbix[wcache,<cache>,<mode>]

As estatísticas e disponibilidade do cache de escrita do Zabbix.
Valores de retorno: Integer (para número/tamanho); Float (para porcentagem).

Parâmetros:

• cache - values, history, index ou trend;
• mode - (com values) all (padrão) - o número total de valores processados pelo Zabbix server/proxy, exceto items não suportados (contador);
  float - o número de valores float processados (contador);
  uint - o número de valores unsigned integer processados (contador);
  str - o número de valores character/string processados (contador);
  log - o número de valores log processados (contador);
  text - o número de valores text processados (contador);
  not supported - o número de vezes que o processamento do item resultou em item se tornando não suportado ou mantendo esse estado (contador);
  (com cache history, index, trend) pfree (padrão) - a porcentagem de buffer livre;
  total - o tamanho total do buffer;
  free - o tamanho do buffer livre;
  used - o tamanho do buffer usado;
  pused - a porcentagem do buffer usado.

Comentários:

• Especificar <cache> é obrigatório. O parâmetro de cache trend não é suportado com o Zabbix proxy.
• O cache de history é usado para armazenar valores de items. Um número baixo indica problemas de desempenho no lado do banco de dados.
• O cache de index de history é usado para indexar os valores armazenados no cache de history.
• Após o cache de history ser preenchido e então limpo, o cache de index de history ainda manterá alguns dados. Esse comportamento é esperado e ajuda o sistema a funcionar de forma mais eficiente, evitando o processamento extra necessário para redimensionar constantemente a memória.
• O cache de trend armazena o agregado para a hora atual para todos os items que recebem dados.
• Você pode usar a chave zabbix[wcache,values] com a etapa de pré-processamento Change per second para obter estatísticas de valores por segundo.