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

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

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

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

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

Telegram

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

  1. 1.Откройте Telegram и найдите бота @pingzen_bot
  2. 2.Отправьте команду /start для получения вашего Chat ID
  3. 3.Скопируйте Chat ID (числовой идентификатор)
  4. 4.В PingZen перейдите в Оповещения → Создать оповещение
  5. 5.Выберите канал Telegram и вставьте Chat ID

Для групповых уведомлений добавьте бота в группу и используйте Chat ID группы (начинается с -100).

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

Webhook интеграция для Discord серверов.

  1. 1.В Discord откройте Server Settings → Integrations → Webhooks
  2. 2.Нажмите 'New Webhook' и выберите канал
  3. 3.Скопируйте Webhook URL
  4. 4.В PingZen создайте оповещение типа Discord
  5. 5.Вставьте Webhook URL

Назовите вебхук 'PingZen Alerts' для удобства идентификации.

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

Webhook

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

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

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

{
  "event": "monitor_down",
  "monitor": {
    "id": 123,
    "name": "My Website",
    "url": "https://example.com",
    "status": "down"
  },
  "timestamp": "2025-01-15T10:30:00Z",
  "error_message": "Connection timeout"
}

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

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

DOWN

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

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

UP

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

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

DEGRADED

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

Отправляется при превышении порога времени отклика или частичных ошибках.

SSL

SSL истекает

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

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

Минимальное время между повторными оповещениями для одной проблемы. Предотвращает спам при нестабильном соединении.

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

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

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

GET/api/v1/alerts

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

POST/api/v1/alerts

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

PUT/api/v1/alerts/:id

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

DELETE/api/v1/alerts/:id

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

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

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

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

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

PingZen поддерживает 19 протоколов: HTTP/HTTPS, WebSocket (WS/WSS), TCP, UDP, ICMP Ping, gRPC, DNS, WHOIS, SSL сертификаты, Email (SMTP/IMAP/POP3), FTP/FTPS, DNSBL и SafeBrowsing. Вы можете мониторить сайты, API, серверы, базы данных и любые сетевые сервисы.

Как быстро приходят оповещения?

Telegram оповещения доставляются в течение 1-2 секунд после обнаружения. Slack и Discord уведомления приходят практически мгновенно. Вы можете настроить несколько каналов оповещений для резервирования.

Можно ли организовать мониторы по проектам?

Да! PingZen поддерживает рабочие пространства, которые позволяют организовать мониторы по проектам, окружениям или командам. Каждое рабочее пространство может иметь свои настройки оповещений и участников.

Есть ли API для автоматизации?

Абсолютно. PingZen предоставляет полный REST API с OpenAPI документацией. Вы можете создавать, обновлять и удалять мониторы программно.

Как работают статус-страницы?

Статус-страницы — это публичные брендированные страницы, показывающие аптайм ваших сервисов. Вы можете использовать пользовательский домен (status.yourdomain.com), отображать статус в реальном времени и позволить клиентам подписаться на обновления.

Что происходит, если я достигну лимита мониторов?

Мы уведомим вас при приближении к лимиту. Вы можете приостановить некоторые мониторы или связаться с нами для увеличения лимита. Мы никогда не останавливаем мониторинг без предупреждения, обеспечивая защиту ваших критически важных сервисов.

Готовы перестать пропускать даунтаймы?

Присоединяйтесь к тысячам команд, которые доверяют PingZen. Настройка за 30 секунд.

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