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

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

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

Heartbeat мониторинг

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

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

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

Примеры использования

  • Cron-задачи (бэкапы баз данных, ротация логов, скрипты очистки)
  • ETL-пайплайны и обработка данных
  • Фоновые воркеры и обработчики очередей
  • Запланированные отчёты и email-рассылки
  • Скрипты деплоя и CI/CD пайплайны

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

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 дней)
  • Grace-период перед отправкой алерта (до 24 часов)
  • Отслеживание сигналов start/success/fail
  • Полная история пингов с временными метками и данными payload
  • Опциональная аутентификация через заголовок X-Secret
  • Пауза/возобновление без потери конфигурации
  • Работает с любым языком или инструментом, способным делать HTTP-запросы

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

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

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

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