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

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

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

Heartbeat-мониторинг — это пассивный подход: вместо того чтобы PingZen проверял ваш сервис, ваш сервис сам сообщает PingZen «я жив» простым HTTP-запросом. Если PingZen не получит пинг в ожидаемый интервал — отправит алерт.

Для чего подходит

Задачи по расписанию

Бэкапы БД, ротация логов, скрипты очистки, еженедельные отчёты и рассылки. Задача отчитывается после каждого запуска; если отчёт не пришёл вовремя и grace-период истёк — приходит алерт.

Пайплайны и фоновые воркеры

ETL и обработка данных, обработчики очередей, деплой-скрипты и CI/CD. Сигналы start и success/fail показывают не только что задача отработала, но и сколько она шла и чем закончилась.

startsuccessstartfail

Всё, до чего снаружи не достучаться

Задача на ноутбуке, в закрытой сети или за NAT — адреса нет, опрашивать нечего. Heartbeat разворачивает направление: не PingZen идёт к задаче, а задача сама делает один исходящий HTTP-запрос.

Для чего не подходит

Heartbeat ждёт, пока задача сама отчитается. Если есть что опрашивать — опрашивайте:

Что нужно узнатьЧто использовать
Работает ли сайт или API?HTTP-монитор — он проверяет снаружи и не требует менять код
Открыт ли порт, доступен ли хост?Монитор TCP или Ping
Почему задача упала?Вне области — heartbeat знает только, что сигнал пришёл или не пришёл

Как это работает

  1. Создайте heartbeat-монитор в PingZen и получите уникальный URL для пинга
  2. Добавьте HTTP-вызов в конец вашего cron-скрипта или пайплайна
  3. PingZen ожидает получить пинг в настроенный интервал
  4. Если пинг пропущен (плюс grace-период), PingZen отправит алерт

Типы сигналов

PingZen поддерживает несколько типов сигналов для детального отслеживания задач:

Ping (GET)

Простой heartbeat — подтверждение выполнения задачи

Start

Отмечает начало выполнения задачи

Success

Отмечает успешное завершение

Fail

Сообщает о сбое с возможными деталями ошибки

Примеры интеграции

Bash / Cron

# Добавьте в конец вашего cron-скрипта
curl -fsS --retry 3 https://pingzen.dev/api/v1/ping/YOUR_PING_KEY/YOUR_SLUG

Python

import requests
requests.get('https://pingzen.dev/api/v1/ping/YOUR_PING_KEY/YOUR_SLUG', timeout=10)

cURL с сигналами start/success

# Сигнал начала задачи
curl -fsS https://pingzen.dev/api/v1/ping/YOUR_PING_KEY/YOUR_SLUG/start

# ... ваша задача выполняется ...

# Сигнал успеха
curl -fsS https://pingzen.dev/api/v1/ping/YOUR_PING_KEY/YOUR_SLUG/success

Ключевые возможности

  • Уникальный URL эндпоинта для каждого heartbeat-монитора
  • Настраиваемые интервалы (от 1 минуты до 30 дней) — включая еженедельные и ежемесячные cron-задачи
  • Grace-период перед отправкой алерта (от 1 минуты до 24 часов)
  • Примечание для календарно-месячных задач: после месяца в 31 день интервал упирается ровно в лимит (30 дней + 24 часа grace = 31 день), и любая задержка даст ложный DOWN — планируйте такие задачи каждые 30 дней
  • Отслеживание сигналов start/success/fail
  • Полная история пингов с временными метками и данными payload — кликните по heartbeat, чтобы открыть детальный вид с таймлайном приходов пингов и журналом последних пингов
  • Опциональная аутентификация через заголовок X-Secret
  • Пауза/возобновление без потери конфигурации
  • Работает с любым языком или инструментом, способным делать HTTP-запросы

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

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

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

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