Перейти к основному содержимому

Документация

Полное руководство по настройке мониторинга сайтов с PingZen. Документация API, примеры кода и лучшие практики.

Иногда история монитора перестаёт быть полезной: неделю он смотрел на staging-URL, ошибка в настройке нагенерила стену ложных падений, или вы переиспользуете существующий монитор под новый сервис. Если удалить и пересоздать монитор — потеряются его ID, привязки алертов и probe. Сброс статистики — это золотая середина: он стирает накопленные данные и начинает шкалу с нуля, оставляя сам монитор нетронутым.

Это действие необратимо. Отмены нет, резервной копии стёртых данных тоже.

Где это находится

Кнопка живёт в форме редактирования монитора, а не на странице деталей:

  1. Откройте монитор и нажмите Редактировать (или иконку карандаша).
  2. Разверните Дополнительные настройки внизу формы.
  3. Нажмите красную кнопку Сбросить статистику.
  4. Диалог подтверждения попросит ввести имя монитора — кнопка активируется только после совпадения.

Кнопка появляется только при редактировании существующего монитора — при создании её нет.

Что стирается

Удаляется

  • Все отдельные результаты проверок
  • Временная шкала статусов (полосы uptime)
  • Часовые и дневные агрегаты uptime
  • Состояние по probe (последняя ошибка, свежесть)
  • Все инциденты этого монитора (открытый сначала авто-резолвится)
  • История отправленных уведомлений
  • Кэш uptime / времени отклика (статус возвращается в неизвестно)

Сохраняется

  • Сам монитор и его ID
  • Вся конфигурация (URL, протокол, интервал, пороги)
  • Правила алертов, привязанные к монитору
  • Привязки probe и правило агрегации

После сброса монитор продолжает работать по своему расписанию — ближайшая же проверка начинает новую шкалу.

Подтверждение и защита

Сброс статистики защищён двумя слоями, чтобы он не сработал случайно:

  • Подтверждение вводом имени в UI — нужно ввести точное имя монитора; кнопка подтверждения заблокирована до совпадения.
  • Явный флаг в API — запрос обязан содержать confirm: true, иначе он отклоняется с 422 Unprocessable Entity. Это защищает от случайных вызовов из shell или LLM-инструментов.

Для одного монитора одновременно может выполняться только один сброс. Если сброс уже идёт, повторная попытка вернёт 409 Conflict — подождите немного и повторите.

Большие мониторы

Для мониторов с миллионами сохранённых проверок стирание выполняется батчами на сервере и может занять до нескольких минут. UI показывает состояние Сброс… и ждёт завершения до 180 секунд, после чего сообщает, сколько проверок, интервалов и инцидентов удалено. Бейдж статуса монитора, in-flight-состояние и кэш SSL обновляются автоматически после завершения.

API и MCP

Та же операция доступна вне UI:

  • REST: POST /api/v1/monitors/:id/reset-stats с телом { "confirm": true }. Аутентификация и формат ответа описаны в API справочнике →.
  • MCP: инструмент reset_monitor_stats даёт ту же операцию AI-клиентам (помечен как destructive и тоже требует подтверждения).

Нужно просто временно остановить проверки? Используйте Паузу — она замораживает расписание, не трогая историю, и возобновить можно в любой момент.

Частые вопросы

Какие протоколы можно мониторить?

PingZen поддерживает 23 протокола: HTTP/HTTPS, WebSocket (WS/WSS), TCP, UDP, ICMP Ping, gRPC, DNS, WHOIS, 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 секунд.