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

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

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

Руководство по разрешению бота

PingZen идентифицирует себя через заголовки User-Agent и X-PingZen-Check. Используйте это руководство, чтобы добавить запросы мониторинга PingZen в белый список вашего файрвола или WAF.

Как PingZen идентифицирует себя

  • User-Agent: PingZen/1.0 (+https://pingzen.dev/docs/bot)
  • X-PingZen-Check: monitor_id=<ID>
  • Документация: https://pingzen.dev/docs/bot

User-Agent:

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36 PingZen/1.0 (+https://pingzen.dev/docs/bot)

IP-адреса зондов

Все запросы мониторинга отправляются с этих IP-адресов. Добавьте их в белый список файрвола.

API-эндпоинт для получения актуальных IP:

GET /api/v1/probe/ips

Cloudflare WAF

  1. Перейдите в Security → WAF → Custom Rules
  2. Создайте правило: если http.user_agent содержит "PingZen", то Allow
    (http.request.headers["x-pingzen-check"] eq "true")
  3. Или добавьте IP-адреса из списка выше

Совет: правила по IP надёжнее, чем по User-Agent, так как заголовки можно подделать.

AWS WAF

  1. Создайте IP set с IP-адресами PingZen
  2. Добавьте правило в Web ACL: если IP источника в IP set, то Allow

Другие WAF / Файрволы

Общий подход для любого файрвола или WAF:

  • Разрешить запросы с заголовком X-PingZen-Check
  • Разрешить запросы с User-Agent содержащим "PingZen"
  • Разрешить запросы с IP-адресов зондов PingZen (самый надёжный способ)

Проверка настройки

После добавления в белый список запустите проверку из панели PingZen, чтобы убедиться, что монитор получает успешные ответы.

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

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

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

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