Документация
Полное руководство по настройке мониторинга сайтов с PingZen. Документация API, примеры кода и лучшие практики.
Ping-монитор отправляет хосту ICMP echo-запросы и сообщает, что вернулось: сколько пакетов потеряно, сколько занял путь туда-обратно и насколько это время скакало. Это самая низкоуровневая проверка в PingZen — она спрашивает, на месте ли машина, а не работает ли на ней что-то полезное.
Для чего подходит
Серверы, роутеры и сетевое оборудование
Всё, что имеет адрес и отвечает на ICMP: голый VPS, роутер, NAS, принтер. Ни агента, ни открытого порта сервиса, ничего настраивать на той стороне не нужно.
Качество канала, а не только доступность
Потери пакетов и джиттер говорят о шатком соединении больше, чем простое «работает или нет». Канал, который отвечает на каждый запрос, но теряет один пакет из двадцати, стоит заметить до жалоб пользователей.
Отделить «сеть» от «приложения»
Заведите ping-монитор рядом с HTTP-монитором на тот же хост. Если сайт лежит, а ping в порядке — машина жива, а приложение нет.
Для чего не подходит
ICMP отвечает на один вопрос. Для остальных нужны другие мониторы:
| Что нужно узнать | Что использовать |
|---|---|
| Работает ли сайт или API на самом деле? Хост может прекрасно отвечать на ping, пока веб-сервер мёртв | Монитор HTTP / HTTPS |
| Открыт ли конкретный порт и принимает ли он соединения? | Монитор TCP |
| Хост игнорирует ICMP — многие облака, файрволы и CDN режут его по политике, и ping-монитор показывал бы вечную аварию на совершенно здоровом хосте | Монитор TCP на порт, который отвечает, или HTTP-монитор |
| Скоро ли истечёт сертификат? | Монитор TLS/SSL-сертификата |
| Насколько быстро страница грузится у посетителя? Время отклика — это не время загрузки страницы | Монитор PageSpeed или время ответа HTTP-монитора |
Что измеряется
Каждая проверка отправляет несколько echo-запросов и записывает:
- Потери пакетов — доля запросов, оставшихся без ответа
- Время отклика — минимальное, максимальное и среднее по пакетам, которые ответили
- Джиттер — насколько время отклика скакало между пакетами; именно из-за него заикаются звонки и видео, даже когда среднее выглядит нормально
Логика статусов
По умолчанию ping-монитор просто работает или не работает: пороги выключены, пока вы их не зададите, а ноль означает «отключено».
| Результат | Статус |
|---|---|
| Пакеты вернулись, ни один порог не превышен | UP |
| Потери или время отклика выше порога предупреждения | WARNING |
| Потери или время отклика выше критического порога | DEGRADED |
| Потеряны все пакеты или хост не резолвится | DOWN |
Деградация ping-монитора — это не авария: хост отвечает, просто плохо. Инцидент не открывается, аптайм не теряется.
Настройки
Хост
Имя хоста или IP-адрес. Без порта — у ICMP его нет.
Количество пакетов
Сколько echo-запросов на проверку. По умолчанию четыре, допустимо от одного до десяти. Чем больше пакетов, тем осмысленнее цифра потерь: один пакет может показать только 0% или 100%.
Размер пакета
По умолчанию 64 байта, от 32 до 1500. Крупные пакеты вскрывают проблемы с MTU и фрагментацией, которые мелкие не показывают.
Пороги по потерям пакетов
Проценты для предупреждения и критического уровня. По умолчанию выключены. На канале, который должен быть чистым, предупреждение на нескольких процентах ловит проблему рано.
Пороги по времени отклика
Время в миллисекундах для предупреждения и критического уровня. По умолчанию выключены. Ставьте их от измеренной базовой линии, а не наугад — см. как мы измеряем задержку.
Ключевые возможности
- Потери пакетов, минимальное, максимальное и среднее время отклика и джиттер на каждой проверке
- Отдельные пороги предупреждения и критического уровня для потерь и для задержки, оба необязательны
- Состояния деградации и предупреждения не считаются простоем
- Работает с любым хостом, отвечающим на ICMP, на цели ничего ставить не надо
Частые вопросы
Какие протоколы можно мониторить?
PingZen поддерживает 23 протокола: HTTP/HTTPS, WebSocket (WS/WSS), TCP, UDP, ICMP Ping, gRPC, DNS, WHOIS, TLS/SSL сертификаты, Email (SMTP/IMAP/POP3), FTP/FTPS, DNSBL, PageSpeed, SOCKS5, MTProxy, API Check и Transaction. Вы можете мониторить сайты, API, серверы, базы данных и любые сетевые сервисы.
Как быстро приходят оповещения?
Telegram оповещения доставляются в течение 1-2 секунд после обнаружения. Slack и Discord уведомления приходят практически мгновенно. Вы можете настроить несколько каналов оповещений для резервирования.
Можно ли организовать мониторы по проектам?
Да! PingZen поддерживает рабочие пространства, которые позволяют организовать мониторы по проектам, окружениям или командам. Каждое рабочее пространство может иметь свои настройки оповещений и участников.
Есть ли API для автоматизации?
Абсолютно. PingZen предоставляет полный REST API с OpenAPI документацией. Вы можете создавать, обновлять и удалять мониторы программно.
Как работают статус-страницы?
Статус-страницы — это публичные брендированные страницы, показывающие аптайм ваших сервисов. Вы можете отображать статус в реальном времени и позволить клиентам подписаться на обновления.
Что происходит, если я достигну лимита мониторов?
Мы уведомим вас при приближении к лимиту. Вы можете приостановить некоторые мониторы или связаться с нами для увеличения лимита. Мы никогда не останавливаем мониторинг без предупреждения, обеспечивая защиту ваших критически важных сервисов.
Готовы перестать пропускать даунтаймы?
Присоединяйтесь к тысячам команд, которые доверяют PingZen. Настройка за 30 секунд.