5 Zabbix internal

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 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.

Checks suportados

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

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 itens e parâmetros de item rotulados como "não suportado em proxy" só podem ser recuperados se o host for monitorado pelo server. Da mesma forma, valores "não suportados em server" só podem ser recuperados se o host for monitorado por 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.
• Os campos retornados correspondem principalmente às propriedades do objeto de nó de alta disponibilidade.
• Campos adicionais:
  • db_timestamp — hora atual do server (timestamp Unix) incluída na resposta
  • lastaccess_age — segundos desde o último heartbeat do nó (db_timestamp - lastaccess)
  • status — estado do nó:
    • 0 — standby
    • 1 — parado manualmente
    • 2 — indisponível
    • 3 — ativo

Exemplo de valores de retorno:

[
  {
    "id": "ckvupihk70001z8mkpw5cg0u3",
    "name": "zabbix-prod-01",
    "status": 3,
    "address": "10.0.4.12:10051",
    "port": 10051,
    "lastaccess": 1756115995,
    "db_timestamp": 1756116000,
    "lastaccess_age": 5
  },
  {
    "id": "ckvx2a9k70004b1nq2hz9d7f",
    "name": "zabbix-standby-02",
    "status": 0,
    "address": "10.0.4.13:10051",
    "port": 10051,
    "lastaccess": 1756115550,
    "db_timestamp": 1756116000,
    "lastaccess_age": 450
  },
  {
    "id": "ckw0bq3l70007y4r1a0m5kz8",
    "name": "zabbix-backup-eu1",
    "status": 1,
    "address": "backup.example.com:10051",
    "port": 10051,
    "lastaccess": 1756105080,
    "db_timestamp": 1756116000,
    "lastaccess_age": 10920
  }
]

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 está 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 tipo específico de verificações no host.
Valores retornados: 0 - indisponí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 à inalcançabilidade/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: "7.4.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 processo específico do Zabbix ou um grupo de processos (identificados por <type> e <mode>) passou em <state>. É calculada apenas para o último minuto.
Valor de retorno: Float.

Parâmetros:

• type - para server processes: 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 proxy processes: 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 fica entre 1 e 4);
• state - busy - o processo está em estado ocupado, por exemplo, processando a 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 estiver em execução (por exemplo, com 5 pollers em execução, o <mode> é especificado como 6), esse item ficará sem suporte.
• Mínimo e máximo referem-se à porcentagem de uso de um único processo. Assim, 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 informam o que estão fazendo na memória compartilhada, e o processo de self-monitoring resume esses dados a cada segundo. As mudanças de estado (busy/idle) são registradas no momento da alteração - assim, um processo que se torna busy é registrado como tal e não altera nem atualiza o estado até ficar idle. Isso garante que até processos totalmente travados sejam registrados corretamente como 100% busy.
• Atualmente, "busy" significa "não dormindo", mas no futuro estados adicionais poderão ser introduzidos - aguardando bloqueios, executando consultas ao banco de dados, etc. Observe que os pollers assíncronos são considerados busy se tiverem atingido o limite definido pelo parâmetro de configuração MaxConcurrentChecksPerPoller server/proxy.
• No Linux e na maioria dos outros sistemas, a resolução é de 1/100 de segundo.

Exemplos:

zabbix[process,poller,avg,busy] #the average time of poller processes spent doing something during the last minute
zabbix[process,"icmp pinger",max,busy] #the maximum time spent doing something by any ICMP pinger process during the last minute
zabbix[process,"history syncer",2,busy] #the time spent doing something by history syncer number 2 during the last minute
zabbix[process,trapper,count] #the amount of currently running trapper processes

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

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

Parâmetros:

• name - o nome do proxy;
• param - lastaccess - o timestamp da última mensagem de heartbeat recebida do proxy;
  delay - por quanto tempo os valores coletados permanecem não enviados; calculado como "proxy delay" + ("current server time" - "proxy lastaccess"), onde "proxy delay" é a diferença entre o horário 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 no 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-se aproximadamente com "Desempenho necessário do servidor, novos valores por segundo" em Relatórios > Informações do sistema.

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

Retorna as métricas internas de um server ou proxy do Zabbix. Se <ip> e <port> forem especificados, as métricas são obtidas da instância remota; caso contrário, da instância local.
Valores de retorno: objeto JSON.

Parâmetros:

• ip - a lista de IP/DNS/máscara de rede de 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 a partir dos endereços listados no parâmetro 'StatsAllowedIP' server/proxy na instância de destino.
• Um conjunto selecionado de métricas internas é retornado por este item. Para detalhes, consulte Remote monitoring of Zabbix stats.

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

Retorna as métricas internas da fila (veja zabbix[queue,<from>,<to>]) de um server ou proxy do Zabbix. Se <ip> e <port> forem especificados, as métricas serão obtidas da instância remota; caso contrário, da instância local.
Valores de retorno: objeto JSON.

Parâmetros:

• ip - a lista de IP/DNS/máscara de rede de 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);
• from - atrasado em pelo menos (o padrão é 6 segundos);
• to - atrasado em no máximo (o padrão é infinito).

Comentários:

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

zabbix[tcache,cache,<parâmetro>]

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

Parâmetros:

• parâmetro - 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 - o número de items em cache;
  requests - o 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 eficácia do cache de valores do Zabbix.
Valor de retorno: Integer. Se <parameter> for definido como mode, o valor de retorno será: 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: 7.4.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 a disponibilidade do cache de gravação 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 itens não suportados (contador);
  float - o número de valores float processados (contador);
  uint - o número de valores inteiros sem sinal processados (contador);
  str - o número de valores de caractere/string processados (contador);
  log - o número de valores de log processados (contador);
  text - o número de valores de texto processados (contador);
  bin - o número de valores binários processados (contador);
  not supported - o número de vezes em que o processamento do item resultou em o item se tornar não suportado ou em permanecer nesse 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:

• O parâmetro de cache trend não é suportado com Zabbix proxy.
• O cache de histórico é usado para armazenar valores de item. Um número baixo indica problemas de desempenho no lado do banco de dados.
• O cache de índice de histórico é usado para indexar os valores armazenados no cache de histórico.
• Depois que o cache de histórico é preenchido e então limpo, o cache de índice de histórico ainda manterá alguns dados. Esse comportamento é esperado e ajuda o sistema a funcionar com mais eficiência, evitando o processamento extra necessário para redimensionar constantemente a memória.
• O cache de tendências armazena o agregado da hora atual para todos os itens 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.