Документация
Полное руководство по настройке мониторинга сайтов с PingZen. Документация API, примеры кода и лучшие практики.
Мониторинг PageSpeed
Мониторинг производительности сайта с помощью Google PageSpeed Insights (Lighthouse). PingZen периодически вызывает PageSpeed API и отслеживает показатели Performance, Accessibility, SEO и Best Practices, а также Core Web Vitals (LCP, FCP, TBT, CLS, Speed Index).
Как это работает
- PingZen отправляет URL вашего сайта в Google PageSpeed Insights API v5
- Google выполняет полный аудит Lighthouse (стратегия mobile или desktop)
- PingZen получает оценки (0-100) по категориям: Performance, Accessibility, SEO, Best Practices
- Извлекаются Core Web Vitals: LCP, FCP, TBT, CLS, Speed Index
- Если оценка Performance ниже вашего порога — статус монитора меняется на DEGRADED
Core Web Vitals
Core Web Vitals от Google измеряют реальный пользовательский опыт:
LCP (Largest Contentful Paint)
Время до отрисовки самого крупного элемента контента. Хорошо: < 2.5с, Нужно улучшить: 2.5-4с, Плохо: > 4с.
FCP (First Contentful Paint)
Время до появления первого текста или изображения. Хорошо: < 1.8с, Нужно улучшить: 1.8-3с, Плохо: > 3с.
TBT (Total Blocking Time)
Суммарное время блокировки основного потока после FCP. Хорошо: < 200мс, Нужно улучшить: 200-600мс, Плохо: > 600мс.
CLS (Cumulative Layout Shift)
Оценка визуальной стабильности. Измеряет неожиданные сдвиги элементов. Хорошо: < 0.1, Нужно улучшить: 0.1-0.25, Плохо: > 0.25.
Speed Index
Скорость визуального заполнения страницы контентом. Хорошо: < 3.4с, Нужно улучшить: 3.4-5.8с, Плохо: > 5.8с.
Оценки Lighthouse
Каждая категория аудита получает оценку от 0 до 100:
Performance (0-100)
Взвешенная комбинация Core Web Vitals и других метрик производительности. Используется для пороговых алертов.
Accessibility (0-100)
Соответствие WCAG: контраст, ARIA, метки, навигация клавиатурой, семантический HTML.
SEO (0-100)
Мета-теги, сканируемость, мобильная адаптация, структурированные данные, канонические URL.
Best Practices (0-100)
HTTPS, отсутствие mixed content, современные API, отсутствие устаревших библиотек, CSP заголовки.
Настройка
URL
URL страницы для анализа. Должен быть публично доступен. Рекомендуется HTTPS.
Стратегия
Выберите Mobile или Desktop. Mobile использует ограниченную сеть и CPU для симуляции среднего телефона. Desktop — без ограничений.
Порог Performance
Порог оценки производительности (0-100). Если оценка опустится ниже — статус монитора станет DEGRADED и сработают алерты. По умолчанию: 50.
Логика статусов
Статус монитора определяется оценкой Performance и вашим порогом:
| Статус | Условие |
|---|---|
| UP | Оценка Performance >= порог |
| DEGRADED | Оценка Performance < порог |
| DOWN | Ошибка API, невалидный URL или квота исчерпана |
Сценарии использования
- Отслеживание регрессий производительности после деплоев
- Мониторинг Core Web Vitals для ранжирования в Google Search
- Получение алертов при падении производительности ниже допустимого порога
- Сравнение mobile и desktop производительности во времени
- Мониторинг влияния сторонних скриптов на скорость загрузки
- Отслеживание оценок accessibility и SEO наряду с производительностью
Ключевые возможности
- Движок Google Lighthouse — те же оценки, что в Chrome DevTools
- Core Web Vitals: LCP, FCP, TBT, CLS, Speed Index
- 4 категории аудита: Performance, Accessibility, SEO, Best Practices
- Стратегии Mobile и Desktop
- Настраиваемый порог производительности для алертов DEGRADED
- Автоматический retry с экспоненциальным backoff при rate limit (429)
- Бесплатно: 25 000 запросов API в день
Частые вопросы
Какие протоколы можно мониторить?
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 секунд.