2 Verificação simples

Visão geral

As verificações simples são normalmente usadas para verificações remotas de serviços sem agent.

Observe que o Zabbix agent não é necessário para verificações simples. O Zabbix server/proxy é responsável pelo processamento das verificações simples (fazendo conexões externas etc).

Exemplos de uso de verificações simples:

net.tcp.service[ftp,,155]
net.tcp.service[http]
net.tcp.service.perf[http,,8080]
net.udp.service.perf[ntp]

Os campos User name e Password (limitados a 255 caracteres) na configuração do item de verificação simples são usados para itens de monitoramento VMware; caso contrário, são ignorados.

Checks suportados

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

Veja também chaves de item de monitoramento VMware.

Item key Description
icmpping A acessibilidade do host por ping ICMP.
icmppingloss A porcentagem de pacotes perdidos.
icmppingretry A acessibilidade do host por ping ICMP com tentativas de repetição.
icmppingsec O tempo de resposta do ping ICMP.
net.tcp.service Verifica se um serviço está em execução e aceitando conexões TCP.
net.tcp.service.perf Verifica o desempenho de um serviço TCP.
net.udp.service Verifica se um serviço está em execução e respondendo a solicitações UDP.
net.udp.service.perf Verifica o desempenho de um serviço UDP.

Detalhes da chave do item

Parâmetros sem colchetes angulares são obrigatórios. Parâmetros marcados com colchetes angulares < > são opcionais.

icmpping[<target>,<packets>,<interval>,<size>,<timeout>,<options>]


A acessibilidade do host por ping ICMP.
Valor de retorno: 0 - o ping ICMP falha; 1 - o ping ICMP é bem-sucedido.

Parâmetros:

  • target - o IP ou nome DNS do host;
  • packets - o número de pacotes;
  • interval - o tempo entre pacotes sucessivos em milissegundos;
  • size - o tamanho do pacote em bytes;
  • timeout - o tempo limite em milissegundos;
  • options - usado para permitir redirecionamento: se estiver vazio (valor padrão), respostas redirecionadas são tratadas como host de destino indisponível; se definido como allow_redirect, respostas redirecionadas são tratadas como host de destino disponível.

Consulte também a tabela de valores padrão.

Comentário:

  • Se pelo menos um dos pacotes definidos pelo parâmetro packets for retornado, o item retorna 1. Se nenhum dos pacotes for retornado, o item retorna 0.

Exemplo:

icmpping[,4] #Se pelo menos um dos quatro pacotes for retornado, o item retorna 1.
icmppingloss[<target>,<packets>,<interval>,<size>,<timeout>,<options>]


A porcentagem de pacotes perdidos.
Valor de retorno: Float.

Parâmetros:

  • target - o IP ou nome DNS do host;
  • packets - o número de pacotes;
  • interval - o tempo entre pacotes sucessivos em milissegundos;
  • size - o tamanho do pacote em bytes;
  • timeout - o tempo limite em milissegundos;
  • options - usado para permitir redirecionamento: se vazio (valor padrão), respostas redirecionadas são tratadas como host de destino inativo; se definido como allow_redirect, respostas redirecionadas são tratadas como host de destino ativo.

Veja também a tabela de valores padrão.

icmppingretry[<target>,<retries>,<backoff>,<size>,<timeout>,<options>]


Acessibilidade do host por ICMP ping com tentativas. Se o primeiro pacote for bem-sucedido, pare; se o pacote falhar, tente novamente até que o número máximo de tentativas definido no parâmetro retries seja atingido. Este item é útil para reduzir o número de pacotes enviados pela rede.
Valor de retorno: 0 - ICMP ping falhou; 1 - ICMP ping bem-sucedido.

Parâmetros:

  • target - o IP do host ou nome DNS;
  • retries - o número de vezes que uma tentativa de ping em um destino será feita, não incluindo a primeira tentativa (0 ou mais; padrão 1);
  • backoff - o número pelo qual o tempo de espera é multiplicado em cada solicitação sucessiva (intervalo de 1.0-5.0; padrão 1.0);
  • size - o tamanho do pacote em bytes;
  • timeout - o tempo limite em milissegundos;
  • options - usado para permitir redirecionamento: se vazio (valor padrão), as respostas redirecionadas são tratadas como host de destino inativo; se definido como allow_redirect, as respostas redirecionadas são tratadas como host de destino ativo.

Veja também a tabela de valores padrão.

icmppingsec[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>]


O tempo de resposta do ICMP ping (em segundos).
Valor de retorno: Float.

Parâmetros:

  • target - o IP ou nome DNS do host;
  • packets - o número de pacotes;
  • interval - o tempo entre pacotes sucessivos em milissegundos;
  • size - o tamanho do pacote em bytes;
  • timeout - o tempo limite em milissegundos;
  • mode - valores possíveis: min, max ou avg (padrão);
  • options - usado para permitir redirecionamento: se vazio (valor padrão), respostas redirecionadas são tratadas como host de destino inativo; se definido como allow_redirect, respostas redirecionadas são tratadas como host de destino ativo.

Comentários:

  • Pacotes que são perdidos ou atingem o tempo limite não são usados no cálculo;
  • Se o host não estiver disponível (tempo limite atingido), o item retornará 0;
  • Se o valor de retorno for menor que 0,0001 segundos, o valor será definido como 0,0001 segundos;
  • Veja também a tabela de valores padrão.
net.tcp.service[service,<ip>,<port>]


Verifica se um serviço está em execução e aceitando conexões TCP.
Valor de retorno: 0 - o serviço está inativo; 1 - o serviço está em execução.

Parâmetros:

  • service - valores possíveis: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (veja detalhes);
  • ip - o endereço IP ou nome DNS (por padrão, o IP/DNS do host é usado);
  • port - o número da porta (por padrão, o número da porta padrão do serviço é usado).

Comentários:

  • Observe que com o serviço tcp a indicação da porta é obrigatória;
  • Essas verificações podem resultar em mensagens adicionais nos arquivos de log do daemon do sistema (sessões SMTP e SSH geralmente são registradas);
  • A verificação de protocolos criptografados (como IMAP na porta 993 ou POP na porta 995) atualmente não é suportada. Como alternativa, use net.tcp.service[tcp,<ip>,port] para verificações como essas.

Exemplo:

net.tcp.service[ftp,,45] #Este item pode ser usado para testar a disponibilidade do servidor FTP na porta TCP 45.

Se o SELinux estiver em modo de reforço, verificações simples TCP/UDP personalizadas podem ser bloqueadas pela política. Para verificar e permitir a nova conexão de saída, revise as negações de auditoria: com grep denied /var/log/audit/audit.log

net.tcp.service.perf[service,<ip>,<port>]


Verifica o desempenho de um serviço TCP.
Valor de retorno: Float: 0.000000 - o serviço está inativo; segundos - o número de segundos gastos ao conectar-se ao serviço.

Parâmetros:

  • service - valores possíveis: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (veja detalhes);
  • ip - o endereço IP ou nome DNS (por padrão, o IP/DNS do host é usado);
  • port - o número da porta (por padrão, o número da porta padrão do serviço é usado).

Comentários:

  • Observe que com o serviço tcp a indicação da porta é obrigatória;
  • A verificação de protocolos criptografados (como IMAP na porta 993 ou POP na porta 995) atualmente não é suportada. Como alternativa, use net.tcp.service[tcp,<ip>,port] para verificações como essas.

Exemplo:

net.tcp.service.perf[ssh] #Este item pode ser usado para testar a velocidade da resposta inicial do servidor SSH.
net.udp.service[service,<ip>,<port>]


Verifica se um serviço está em execução e respondendo a solicitações UDP.
Valor de retorno: 0 - o serviço está inativo; 1 - o serviço está em execução.

Parâmetros:

  • service - valores possíveis: ntp (veja detalhes);
  • ip - o endereço IP ou nome DNS (por padrão, o IP/DNS do host é usado);
  • port - o número da porta (por padrão, o número da porta padrão do serviço é usado).

Exemplo:

net.udp.service[ntp,,45] #Este item pode ser usado para testar a disponibilidade do serviço NTP na porta UDP 45.
net.udp.service.perf[service,<ip>,<port>]


Verifica o desempenho de um serviço UDP.
Valor de retorno: Float: 0.000000 - o serviço está inativo; segundos - o número de segundos gastos aguardando a resposta do serviço.

Parâmetros:

  • service - valores possíveis: ntp (veja detalhes);
  • ip - o endereço IP ou nome DNS (por padrão, o IP/DNS do host é usado);
  • port - o número da porta (por padrão, o número da porta padrão do serviço é usado).

Exemplo:

net.udp.service.perf[ntp] #Este item pode ser usado para testar o tempo de resposta do serviço NTP.

Para suporte a SourceIP em verificações simples de LDAP (por exemplo, net.tcp.service[ldap]), é necessário o OpenLDAP versão 2.6.1 ou superior.

Processamento de timeout

O Zabbix não processará uma verificação simples por mais tempo do que os segundos de Timeout definidos no formulário de configuração do item. Para itens VMware, o Zabbix não processará uma verificação simples por mais tempo do que os segundos de Timeout definidos no arquivo de configuração do server ou proxy do Zabbix. Para itens icmpping*, os valores de timeout e retries são especificados diretamente na chave do item e não são influenciados pelo parâmetro global Timeout. Certifique-se de que esses valores estejam configurados adequadamente na chave do item. Observe que um timeout máximo possível fixo de 600 segundos é aplicado aos itens icmpping* (desde o Zabbix 7.4.6).

Pings ICMP

O Zabbix usa um utilitário externo fping para processar pings ICMP (icmpping, icmppingloss, icmppingretry, icmppingsec).

Instalação

fping não está incluído no Zabbix e precisa ser instalado separadamente:

  • Várias plataformas baseadas em Unix possuem o pacote fping em seus repositórios padrão, mas ele não é pré-instalado. Neste caso, você pode usar o gerenciador de pacotes para instalar o fping.

  • O Zabbix fornece pacotes fping para RHEL e seus derivados. Observe que esses pacotes são fornecidos sem suporte oficial.

  • O fping também pode ser compilado a partir do código-fonte.

Configuração

Especifique o local do fping no parâmetro FpingLocation do arquivo de configuração do Zabbix server/proxy (ou o parâmetro Fping6Location para usar endereços IPv6).

O fping deve ser executável pelo usuário com o qual o Zabbix server/proxy é executado, e esse usuário deve ter permissões suficientes.

Veja também: Problemas conhecidos para o processamento de verificações simples com versões do fping abaixo de 3.10.

Valores padrão

Padrões, limites e descrição dos valores dos parâmetros de verificação ICMP:

Parameter Unit Description Fping's flag Defaults set by Allowed limits
by Zabbix
fping Zabbix min max
packets number Número de pacotes de requisição enviados a um alvo -C 3 1 10000
interval milliseconds Tempo de espera entre pacotes sucessivos para um alvo individual -p 1000 20 unlimited
size bytes Tamanho do pacote em bytes
56 bytes em x86, 68 bytes em x86_64
-b 56 or 68 24 65507
timeout milliseconds fping v3.x - tempo limite para aguardar após o último pacote enviado, afetado pela flag -C
fping v4.x - tempo limite individual para cada pacote
-t fping v3.x - 500
fping v4.x e versões mais recentes - herdado da flag -p, mas não mais que 2000
50 unlimited
retries number Número de vezes que uma tentativa de ping em um alvo será feita, sem incluir a primeira tentativa -r 3 1 0 unlimited
backoff factor number Número pelo qual o tempo de espera é multiplicado em cada requisição sucessiva -B 1.5 1.0 1.0 5.0

Os padrões podem diferir ligeiramente dependendo da plataforma e da versão.

Além disso, o Zabbix usa as opções do fping -i interval ms (não confunda com o parâmetro do item interval mencionado na tabela acima, que corresponde à opção -p do fping) e -S source IP address (ou -I em versões mais antigas do fping). Essas opções são detectadas automaticamente executando verificações com diferentes combinações de opções. O Zabbix tenta detectar o valor mínimo em milissegundos que o fping permite usar com -i testando 3 valores: 0, 1 e 10. O valor que primeiro tiver sucesso é então usado nas verificações ICMP subsequentes. Esse processo é realizado por cada processo ICMP pinger individualmente.

As opções do fping detectadas automaticamente são invalidadas a cada hora e detectadas novamente na próxima tentativa de executar a verificação ICMP. Defina DebugLevel>=4 para ver detalhes desse processo no arquivo de log do server ou proxy.

O Zabbix grava os endereços IP a serem verificados por qualquer uma das chaves icmpping* em um arquivo temporário, que então é passado ao fping. Se os items tiverem diferentes parâmetros de chave, apenas aqueles com parâmetros de chave idênticos são gravados em um único arquivo. Todos os endereços IP gravados no arquivo único serão verificados pelo fping em paralelo, portanto o processo ICMP pinger do Zabbix gastará uma quantidade fixa de tempo, independentemente do número de endereços IP no arquivo.