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

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

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

Публичные статус-страницы

Статус-страницы позволяют создать публичную страницу с информацией о состоянии ваших сервисов. Пользователи могут проверить статус без регистрации.

Возможности

Публичный URL

Каждая статус-страница получает уникальный URL вида pingzen.dev/status/ваш-slug.

Кастомизация

Настройте название, описание и тему (светлая/тёмная) страницы.

Выбор мониторов

Добавьте только те мониторы, статус которых хотите показывать публично.

Аптайм и SLA

Отображает процент доступности (24ч, 7д, 30д, 90д) и полосы аптайма с учётом часового пояса для каждого монитора.

Реальное время

Статус обновляется автоматически без перезагрузки страницы.

Индексация поисковиками

Управляйте индексацией статус-страницы поисковыми системами с помощью переключателя allow_indexing.

Часовой пояс отображения

Выберите как время показывается посетителям. Авто (по умолчанию) рендерит каждую метку времени в часовом поясе браузера посетителя — подходит для глобальной аудитории. Закрепление IANA-пояса (например Europe/Moscow) показывает всем одно и то же время с подписью в подвале страницы (Время указано в Europe/Moscow (MSK)). Полная модель — в разделе Часовые пояса.

Без авторизации

Публичные страницы доступны всем без регистрации.

Как создать

  1. Перейдите в раздел «Статус-страницы» в боковом меню
  2. Нажмите «Создать статус-страницу»
  3. Введите название и уникальный slug (URL-адрес)
  4. Выберите мониторы для отображения
  5. Сохраните и скопируйте публичный URL

SLA-отчёты (PDF)

В шапке каждой публичной статус-страницы есть кнопка «Скачать SLA-отчёт». Любой посетитель — без регистрации — получает PDF-слепок страницы, готовый для SLA-ревью, постмортема или письма клиенту.

Отчёт покрывает последние 90 дней и содержит только то, что уже видно на публичной странице — ID мониторов, внутренние тексты ошибок и детали задержек в него не попадают:

  • Текущий статус и общий аптайм за 90 дней по активно мониторящимся сервисам
  • Аптайм каждого сервиса в окнах 24ч / 7д / 30д / 90д
  • Полоса дневного аптайма за 90 дней для каждого монитора
  • История инцидентов (50 последних) и окна плановых техработ

Цифры в PDF совпадают со страницей — оба строятся из одного снимка данных:

  • Метки времени следуют настройке часового пояса страницы.
  • Мониторы на паузе показываются как Paused с N/A в окнах без данных и исключаются из среднего аптайма.
  • Частичные (региональные) сбои получают половинный кредит аптайма — то же правило, что и в остальных SLA-расчётах PingZen.
  • Отчёт генерируется на лету и всегда отражает текущее состояние страницы. Юникод (кириллические названия страниц и мониторов) полностью поддерживается.

Настройка не нужна — кнопка появляется на каждой публичной статус-странице автоматически.

Распространение

Поделитесь URL статус-страницы с вашими пользователями через:

  • Ссылку в футере вашего сайта
  • Email рассылки о техработах
  • Социальные сети
  • Внутреннюю документацию
  • Скачиваемый SLA-отчёт (PDF) для формальных ревью

API статус-страниц

Управляйте статус-страницами через REST API.

GET/api/v1/status-pages

Список статус-страниц

POST/api/v1/status-pages

Создать статус-страницу

PUT/api/v1/status-pages/:id

Обновить статус-страницу

DELETE/api/v1/status-pages/:id

Удалить статус-страницу

POST/api/v1/status-pages/:id/monitors

Добавить мониторы на страницу

GET/api/v1/public/status/:slug/report.pdf

Скачать SLA-отчёт в PDF (публичный, без авторизации)

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

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

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

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