[comment]: # attributes: notoc

[comment]: # ({a6162aaf-be4ab03d})
# 2 Verificação simples

[comment]: # ({/a6162aaf-be4ab03d})

[comment]: # ({05b34fc5-76023448})
### 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 (realizando 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]

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

[comment]: # ({/05b34fc5-76023448})

[comment]: # ({9aaf2d21-f59a5ccc})
### 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](/manual/vm_monitoring/vmware_keys).

|Chave do item|Descrição|
|--|--------|
|[icmpping](#icmpping)|Acessibilidade do host por ICMP ping.|
|[icmppingloss](#icmppingloss)|A porcentagem de pacotes perdidos.|
|[icmppingsec](#icmppingsec)|O tempo de resposta do ICMP ping.|
|[net.tcp.service](#nettcpservice)|Verifica se um serviço está em execução e aceitando conexões TCP.|
|[net.tcp.service.perf](#nettcpserviceperf)|Verifica o desempenho de um serviço TCP.|
|[net.udp.service](#netudpservice)|Verifica se um serviço está em execução e respondendo a solicitações UDP.|
|[net.udp.service.perf](#netudpserviceperf)|Verifica o desempenho de um serviço UDP.|

[comment]: # ({/9aaf2d21-f59a5ccc})

[comment]: # ({b1bc108a-23d7246f})
### Detalhes da chave do item

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

[comment]: # ({/b1bc108a-23d7246f})

[comment]: # ({52d234e4-7d8dff2e})
##### icmpping\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmpping}

<br>
Acessibilidade do host por ICMP ping.<br>
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](#default-values).

Exemplo:

    icmpping[,4] #Se pelo menos um pacote dos quatro for retornado, o item retornará 1.

[comment]: # ({/52d234e4-7d8dff2e})

[comment]: # ({1976ee61-6cd0f1b1})
##### icmppingloss\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmppingloss}

<br>
A porcentagem de pacotes perdidos.<br>
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](#default-values).

[comment]: # ({/1976ee61-6cd0f1b1})

[comment]: # ({5c6701a7-b5636838})
##### icmppingsec\[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>\] {#icmppingsec}

<br>
O tempo de resposta do ping ICMP (em segundos).<br>
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](#default-values).

[comment]: # ({/5c6701a7-b5636838})

[comment]: # ({878d3b27-b0a71170})
##### net.tcp.service[service,<ip>,<port>] {#nettcpservice}

<br>
Verifica se um serviço está em execução e aceitando conexões TCP.<br>
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](/manual/appendix/items/service_check_details));
-   **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* é obrigatório indicar a porta;
-   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.

::: noteimportant
Se o SELinux estiver em modo de reforç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``
:::

[comment]: # ({/878d3b27-b0a71170})

[comment]: # ({39da67f1-946385b4})
##### net.tcp.service.perf[service,<ip>,<port>] {#nettcpserviceperf}

<br>
Verifica o desempenho de um serviço TCP.<br>
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](/manual/appendix/items/service_check_details));
-   **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.

[comment]: # ({/39da67f1-946385b4})

[comment]: # ({5cba2094-2859223a})
##### net.udp.service[service,<ip>,<port>] {#netudpservice}

<br>
Verifica se um serviço está em execução e respondendo a solicitações UDP.<br>
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](/manual/appendix/items/service_check_details));
-   **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.

[comment]: # ({/5cba2094-2859223a})

[comment]: # ({bae0ccf0-9cf5922c})
##### net.udp.service.perf[service,<ip>,<port>] {#netudpserviceperf}

<br>
Verifica o desempenho de um serviço UDP.<br>
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](/manual/appendix/items/service_check_details));
-   **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.

[comment]: # ({/bae0ccf0-9cf5922c})

[comment]: # ({621c13d4-85612a2b})
::: noteimportant
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.
:::

[comment]: # ({/621c13d4-85612a2b})

[comment]: # ({50429666-92a6c4ae})
##### 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](/manual/config/items/item#configuration).
Para [itens VMware](/manual/vm_monitoring/vmware_keys),
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](/manual/appendix/config/zabbix_server#timeout) ou [proxy](/manual/appendix/config/zabbix_proxy#timeout). Para itens [icmpping*](#icmp-pings), 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*](#icmp-pings) (desde o Zabbix 7.0.22).

[comment]: # ({/50429666-92a6c4ae})

[comment]: # ({30611a67-b08a4508})
### Pings ICMP

O Zabbix usa o utilitário externo **[fping](https://fping.org/)** para processar pings ICMP (**icmpping**, **icmppingloss**, **icmppingsec**).

[comment]: # ({/30611a67-b08a4508})

[comment]: # ({d81af73e-e3dd9826})
##### 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](http://repo.zabbix.com/non-supported/rhel/) para RHEL. Observe que esses pacotes são fornecidos sem suporte oficial.

- O fping também pode ser compilado [a partir do código-fonte](https://github.com/schweikert/fping/blob/develop/README.md#installation).

[comment]: # ({/d81af73e-e3dd9826})

[comment]: # ({1f866e68-9ced6345})
##### Configuração

Especifique a localização do fping no parâmetro *[FpingLocation](/manual/appendix/config/zabbix_server#fpinglocation)* do arquivo de configuração do server/proxy Zabbix 
(ou o parâmetro *[Fping6Location](/manual/appendix/config/zabbix_server#fping6location)* para usar endereços IPv6).

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

Veja também: [Problemas conhecidos](/manual/installation/known_issues#simple-checks) para o processamento de verificações simples com versões do fping inferiores à 3.10.

[comment]: # ({/1f866e68-9ced6345})

[comment]: # ({674ffe07-3c21487d})
##### Valores padrão

Valores padrão, limites e descrição dos valores para os parâmetros de verificação ICMP:

|Parâmetro|Unidade|Descrição|Flag do fping|Valores padrão definidos por|<|Limites permitidos<br>pelo Zabbix|<|
|--|--|--------|-|--|--|--|--|
| | | | |**fping**|**Zabbix**|**mín**|**máx**|
|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<br>56 bytes em x86, 68 bytes em x86_64|-b|56 ou 68| |24|65507|
|timeout|milissegundos|**fping v3.x** - tempo limite de espera após o envio do último pacote, afetado pela flag *-C*<br> **fping v4.x** - tempo limite individual para cada pacote|-t|**fping v3.x** - 500<br>**fping v4.x** e mais recentes - herdado da flag *-p*, mas não superior a 2000| |50|ilimitado|

Os valores padrão 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 confundir com o parâmetro de item *interval* mencionado na tabela acima,
que corresponde à opção *-p* do fping) 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*, testando 3 valores: 0, 1 e 10.
O primeiro valor que funcionar será então usado nas verificações ICMP subsequentes.
Esse processo é realizado individualmente por cada processo [ICMP pinger](/manual/concepts/server#server-process-types-and-threads).

As opções do fping detectadas automaticamente são invalidadas a cada hora e detectadas novamente na próxima tentativa de executar uma verificação ICMP.
Defina [DebugLevel](/manual/appendix/config/zabbix_server#debuglevel)>=4 para visualizar os 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 três chaves *icmpping\** em um arquivo temporário, que é então passado ao fping.
Se os itens tiverem parâmetros de chave diferentes, somente aqueles com parâmetros de chave idênticos serã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, independentemente do número de endereços IP no arquivo.

[comment]: # ({/674ffe07-3c21487d})