5 Verificações simples
Visão geral
As verificações simples são normalmente usadas para verificações remotas sem agent de serviços.
Observe que o agent Zabbix não é necessário para verificações simples. O server/proxy Zabbix é 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 Nome de usuário e Senha (limitados a 255 caracteres) na configuração do item de verificação simples são usados para itens de monitoramento VMware; ignorados caso contrário.
Verificações suportadas
As chaves de item são listadas sem parâmetros opcionais e informações adicionais. Clique na chave do item para ver os detalhes completos.
Veja também chaves de item de monitoramento VMware.
| Chave do item | Descrição |
|---|---|
| icmpping | Acessibilidade do host por ICMP ping. |
| icmppingloss | A porcentagem de pacotes perdidos. |
| icmppingretry | Acessibilidade do host por ICMP ping com tentativas. |
| icmppingsec | O tempo de resposta do ICMP ping. |
| 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>]
Acessibilidade do host por ICMP ping.
Valor de retorno: 0 - ICMP ping falhou; 1 - ICMP ping bem-sucedido.
Parâmetros:
- target - o IP do host ou nome DNS;
- 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.
Exemplo:
icmpping[,4] #Se pelo menos um pacote dos quatro for retornado, o item retornará 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 a 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), 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.
icmppingsec[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>]
O tempo de resposta do ping ICMP (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 execução, verificações simples personalizadas de TCP/UDP 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 do que os segundos definidos em Timeout no formulário de configuração do item.
Para itens VMware,
o Zabbix não processará uma verificação simples por mais do que os segundos definidos em Timeout no arquivo de configuração do Zabbix server ou proxy. Para itens icmpping*, os valores de timeout e tentativas 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 tempo limite máximo possível codificado de 600 segundos é aplicado aos itens icmpping* (desde o Zabbix 7.4.6).
Pings ICMP
O Zabbix usa o 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. Nesse 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 que executa o Zabbix server/proxy e esse usuário deve ter direitos 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
Valores padrão, limites e descrição dos valores para parâmetros de verificação ICMP:
| Parâmetro | Unidade | Descrição | Flag do fping | Padrões definidos por | Limites permitidos pelo Zabbix |
||
|---|---|---|---|---|---|---|---|
| fping | Zabbix | min | max | ||||
| packets | número | Número de pacotes de solicitação enviados para um destino | -C | 3 | 1 | 10000 | |
| interval | milissegundos | Tempo de espera entre pacotes sucessivos para um destino individual | -p | 1000 | 20 | ilimitado | |
| size | bytes | Tamanho do pacote em bytes 56 bytes em x86, 68 bytes em x86_64 |
-b | 56 ou 68 | 24 | 65507 | |
| timeout | milissegundos | 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 mais recente - herdado da flag -p, mas não mais que 2000 |
50 | ilimitado | |
| retries | número | Número de vezes que uma tentativa de ping em um destino será feita, não incluindo a primeira tentativa | -r | 3 | 1 | 0 | ilimitado |
| backoff factor | número | Número pelo qual o tempo de espera é multiplicado a cada solicitação sucessiva | -B | 1.5 | 1.0 | 1.0 | 5.0 |
Os valores padrão podem diferir ligeiramente dependendo da plataforma e versão.
Além disso, o Zabbix usa as opções do fping -i intervalo ms (não confunda com o parâmetro do item interval mencionado na tabela acima, que corresponde à opção do fping -p) e -S endereço IP de origem (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 tentando 3 valores: 0, 1 e 10. O valor que primeiro for bem-sucedido é então usado para as verificações ICMP subsequentes. Esse processo é feito 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 realizar a verificação ICMP. Defina DebugLevel>=4 para visualizar 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 para o fping. Se os items tiverem parâmetros de chave diferentes, apenas aqueles com parâmetros de chave idênticos são gravados em um único arquivo. Todos os endereços IP gravados no mesmo arquivo serão verificados pelo fping em paralelo, portanto, o processo ICMP pinger do Zabbix gastará uma quantidade fixa de tempo, desconsiderando o número de endereços IP no arquivo.