> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Ping (ICMP)

> Monitore a disponibilidade e a latência de qualquer host ou dispositivo via ICMP ping

# Ping (ICMP)

A integração **Ping** monitora se um host está acessível na rede e mede o tempo
de resposta (latência), usando o comando `ping` do sistema — a mesma abordagem
do componente `ping` do Home Assistant.

É útil para acompanhar a disponibilidade de roteadores, NVRs, servidores,
impressoras ou qualquer dispositivo com IP fixo, e também para checar a
conectividade com a internet (ex: `8.8.8.8`).

<Info>
  Roda apenas em um **edge local (home)**. Para pingar dispositivos da sua rede,
  o edge precisa estar na mesma rede — a nuvem não os alcança.
</Info>

## Configurar

<Steps>
  <Step title="Adicione a integração">
    Vá em **Configurações → Integrações → Adicionar → Ping (ICMP)** e selecione
    um edge local.
  </Step>

  <Step title="Informe o alvo">
    Preencha um **Nome** amigável e o **Host** (IP ou hostname). Opcionalmente
    ajuste quantos pacotes enviar por checagem (padrão 5).
  </Step>

  <Step title="Pronto">
    Duas entidades são criadas: um sensor de conectividade e um sensor de
    latência, atualizados a cada minuto.
  </Step>
</Steps>

## Entidades

| Entidade               | Plataforma      | Descrição                                                                                  |
| ---------------------- | --------------- | ------------------------------------------------------------------------------------------ |
| `<nome> Conectividade` | `binary_sensor` | `on` quando o host responde, `off` quando está inacessível (`device_class: connectivity`). |
| `<nome> Latência`      | `sensor`        | Tempo médio de ida-e-volta (RTT) em milissegundos.                                         |

Ambas as entidades expõem, em seus atributos, os valores detalhados da última
checagem: `round_trip_time_min`, `round_trip_time_avg`, `round_trip_time_max`,
`round_trip_time_mdev` e `packet_loss`.

## Dashboard

Use o card **Entity** ou **Sensor** para exibir o status de conectividade e a
latência. O binary\_sensor de conectividade pode alimentar automações — por
exemplo, notificar quando um dispositivo crítico ficar offline.