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

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

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

Настройка оповещений

PingZen поддерживает множество каналов оповещений. Настройте один или несколько каналов для резервирования.

Telegram

Самый быстрый способ получения уведомлений (1-2 секунды). Настройка в одно нажатие.

  1. 1.В PingZen перейдите в Оповещения → Создать оповещение → выберите Telegram
  2. 2.Нажмите «Подключить Telegram» — ссылка на @pingzen_bot откроется автоматически
  3. 3.Нажмите Start в Telegram — аккаунт привяжется мгновенно
  4. 4.Для групповых алертов: переключитесь на вкладку «Групповой чат» и нажмите «Добавить бота в группу»

Копировать Chat ID вручную не нужно — мастер сделает всё автоматически. При необходимости можно ввести Chat ID вручную.

Slack

Интеграция через Incoming Webhooks для командной работы.

  1. 1.В Slack перейдите в Settings → Apps → Incoming Webhooks
  2. 2.Нажмите 'Add New Webhook to Workspace'
  3. 3.Выберите канал для уведомлений
  4. 4.Скопируйте Webhook URL (https://hooks.slack.com/...)
  5. 5.В PingZen создайте оповещение и вставьте URL

Создайте отдельный канал #alerts для оповещений о мониторинге.

Discord

Настройка в одно нажатие через OAuth или вставка Webhook URL.

  1. 1.В PingZen перейдите в Оповещения → Создать оповещение → выберите Discord
  2. 2.Нажмите «Connect Discord» — вы будете перенаправлены в Discord
  3. 3.Выберите сервер и канал, затем подтвердите авторизацию
  4. 4.Вы вернётесь в PingZen — вебхук сохранится автоматически

Можно также вставить Webhook URL вручную. Создайте его в Discord: Server Settings → Integrations → Webhooks.

Microsoft Teams

Отправка оповещений в каналы Microsoft Teams через Incoming Webhook.

  1. 1.В Teams выберите канал → More options → Connectors
  2. 2.Найдите 'Incoming Webhook' и нажмите Configure
  3. 3.Дайте имя вебхуку и скопируйте URL
  4. 4.В PingZen создайте оповещение типа MS Teams
  5. 5.Вставьте Webhook URL

Mattermost

Slack-совместимые вебхуки для self-hosted команд.

  1. 1.В Mattermost: Main Menu → Integrations → Incoming Webhooks
  2. 2.Нажмите Add Incoming Webhook
  3. 3.Выберите канал и скопируйте Webhook URL
  4. 4.В PingZen используйте тип Mattermost

WhatsApp

Получайте оповещения через WhatsApp с помощью Twilio API.

  1. 1.Создайте аккаунт Twilio и настройте WhatsApp Business API
  2. 2.Получите Twilio Account SID, Auth Token и номер WhatsApp
  3. 3.В PingZen создайте оповещение типа WhatsApp
  4. 4.Введите ваш номер WhatsApp (с кодом страны, например +79001234567)

Для WhatsApp-уведомлений необходим аккаунт Twilio с активированным WhatsApp Business API.

PagerDuty

Маршрутизация алертов в PagerDuty для эскалации дежурным.

  1. 1.В PagerDuty перейдите Services → Service Directory → выберите сервис
  2. 2.Вкладка Integrations → Add Integration → Events API v2
  3. 3.Скопируйте Integration Key (routing key)
  4. 4.В PingZen создайте PagerDuty алерт и вставьте routing key

PagerDuty создаёт настоящие инциденты с эскалацией — идеально для продакшн-сервисов.

Push-уведомления в браузере

Мгновенные push-уведомления прямо в браузере — без приложений и расширений.

  1. 1.Перейдите в Настройки → Уведомления в PingZen
  2. 2.Нажмите «Включить push-уведомления»
  3. 3.Разрешите уведомления когда браузер запросит разрешение
  4. 4.Алерты будут доставляться даже когда PingZen не открыт

Push-уведомления работают в Chrome, Firefox и Edge. Требуется HTTPS.

Webhook

Отправка JSON данных на ваш HTTP эндпоинт для кастомных интеграций.

  1. 1.Создайте HTTP эндпоинт на вашем сервере для приёма POST запросов
  2. 2.В PingZen создайте оповещение типа Webhook
  3. 3.Укажите URL вашего эндпоинта
  4. 4.Опционально добавьте заголовки аутентификации

Формат JSON данных

{
  "text": "🔴 My Website - DOWN",
  "body": "URL: https://example.com\nProtocol: HTTPS\nResponse time: 5000 ms\nError: Connection timeout",
  "priority": "critical",
  "timestamp": "2026-03-18T10:30:00+00:00",
  "source": "pingzen"
}

Триггеры оповещений

Выберите события, при которых отправляются уведомления:

DOWN

Сервис недоступен (DOWN)

Отправляется когда монитор переходит в статус DOWN после подтверждения (по умолчанию 3 последовательных ошибки).

UP

Восстановление (RECOVERED)

Отправляется когда монитор восстанавливается после падения.

DEGRADED

Деградация (DEGRADED)

Деградация сервиса (вкл. PageSpeed score ниже порога).

SSL

SSL истекает

Отправляется за 14 дней до истечения SSL сертификата.

Настройки сообщения

Настройте, какая информация включается в уведомления. По умолчанию большинство полей включены. Вы можете переключать каждое поле для каждого оповещения.

✓URL — адрес отслеживаемого эндпоинта
✓Протокол — HTTP, TCP, DNS и т.д.
✓Время отклика — длительность проверки в миллисекундах
✓HTTP статус-код — код ответа (например 200, 502)
✓Сообщение об ошибке — детали сбоя или причина таймаута
—Информация об аккаунте — ваш email или имя аккаунта (по умолчанию отключено для приватности)
✓Длительность простоя — как долго монитор был недоступен (показывается только при восстановлении)
✓Ссылка на монитор — кликабельная ссылка, открывающая страницу монитора в PingZen

Отключите ненужные поля, чтобы уведомления были лаконичными. Поле «Информация об аккаунте» отключено по умолчанию для приватности.

Оповещения для Heartbeat-мониторов

Оповещения работают как с обычными мониторами, так и с heartbeat-мониторами. При создании оповещения можно выбрать heartbeat-мониторы в секции «Heartbeat-мониторы» под списком обычных мониторов.

Одно оповещение может наблюдать одновременно за обычными и heartbeat-мониторами. Счётчик мониторов показывает общее количество обоих типов.

Напоминания

Включите переключатель «Напоминать пока недоступен» для получения периодических уведомлений пока монитор остаётся недоступным. Интервалы нарастают автоматически: 5 мин → 15 мин → 1 час → далее каждые 4 часа. Расписание сбрасывается при восстановлении.

Напоминания отключены по умолчанию. Включите их для критичных сервисов, где нужна постоянная эскалация.

Период ожидания (Cooldown)

Минимальное время между повторными оповещениями для одной проблемы. Предотвращает спам при нестабильном соединении. По умолчанию: 5 минут. Оповещения о восстановлении всегда игнорируют cooldown.

Рекомендуется: 5-15 минут для продакшн окружений.

История оповещений

Вкладка «История» на странице оповещений показывает лог всех отправленных уведомлений: время, тип триггера, канал, получатель и статус доставки (отправлено/ошибка). Неудачные доставки содержат детали ошибки.

Используйте историю для проверки доставки уведомлений и диагностики сбоев.

API для оповещений

Управляйте оповещениями программно через REST API.

GET/api/v1/alerts

Список оповещений

POST/api/v1/alerts

Создать оповещение

PATCH/api/v1/alerts/:id

Обновить оповещение

DELETE/api/v1/alerts/:id

Удалить оповещение

POST/api/v1/alerts/:id/test

Тест оповещения

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

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

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 секунд.

Начать бесплатно