Документация
Полное руководство по настройке мониторинга сайтов с PingZen. Документация API, примеры кода и лучшие практики.
WHOIS-монитор спрашивает у реестра доменов, сколько ещё действует ваша регистрация. Он читает дату окончания и имя регистратора, считает оставшиеся дни и желтеет задолго до этой даты. Вашего сервера он не касается вообще — ответ приходит из реестра, а не от хостинга.
Для чего подходит
Продление, о котором никто не помнит
Домен продлевают раз в год или раз в несколько лет. Ничто в ежедневной работе о нём не напоминает. Письмо о продлении уходит на ящик в этом же домене или человеку, который давно уволился, а карта у регистратора протухла ещё полгода назад.
Домены, за которые платите не вы
Домены клиентов, домены, купленные маркетингом, домены, доставшиеся вместе с проектом. Серверы ведёте вы, а аккаунт у регистратора — кто-то другой. Монитор даёт то предупреждение, которое счёт вам не пришлёт.
Заметить блокировку раньше пользователей
Реестры приостанавливают домены за неоплату, за непройденную проверку контактов, из-за спора. Монитор читает статус регистрации, поэтому домен на hold или снятый с делегирования показывается как упавший, даже если до даты окончания ещё месяцы.
Держать факты о регистрации в одном месте
Каждая проверка сохраняет на мониторе дату окончания и имя регистратора, так что на вопрос «когда истекает и у кого мы его покупали» есть ответ без входа куда-либо.
Для чего не подходит
Этот монитор смотрит на запись о регистрации и больше ни на что. Домен может быть оплачен на пять лет вперёд, пока сайт лежит.
| Что нужно узнать | Что использовать |
|---|---|
| Скоро ли истечёт TLS-сертификат? Это другая дата, у неё другой владелец и другие последствия | Монитор TLS/SSL-сертификата |
| Резолвятся ли DNS-записи и отвечают ли они нужным адресом? | Монитор DNS |
| Работает ли сайт прямо сейчас? | Монитор HTTP / HTTPS |
| Не поменял ли кто-то у регистратора NS-серверы, A-запись или MX? В аккаунт регистратора PingZen не заходит — но может следить за результатом этих настроек | Монитор DNS с ожидаемыми значениями |
| Принимается ли ещё почта для домена? | Монитор SMTP на почтовый хост |
| Не попал ли домен или почтовый сервер в спам-списки? | Монитор DNSBL |
Срок домена — это не срок сертификата
Два монитора устроены одинаково — оба считают дни до даты — и их часто путают. Но даты живут в разных системах, и последствия у них разные.
| Срок сертификата | Срок домена | |
|---|---|---|
| Кому принадлежит дата | Удостоверяющему центру | Реестру доменов и вашему регистратору |
| Как часто наступает | От нескольких дней до нескольких месяцев, обычно продлевается автоматически | Раз в год и реже, обычно продлевается платежом |
| Что ломается, когда дата прошла | HTTPS. Сайт на месте, но браузеры отказываются его открывать. Обычный HTTP, почта и DNS продолжают работать | Само имя. Сайт, все поддомены, вся почта на домен, любой вход по этой почте — всё разом |
| Насколько трудно откатить | Выпустить новый сертификат, минуты | Плата за восстановление, дни ожидания, а после этого окна имя может зарегистрировать кто угодно |
Из-за последней строки пороги здесь шире, чем у монитора сертификата. Просроченный сертификат стоит вам вечера; просроченный домен может стоить самого имени.
Для домена, на котором ещё и сайт, держите оба монитора. Они следят за двумя датами, которые никак не связаны друг с другом.
Что проверяется
Каждая проверка делает один запрос и записывает:
- Дней до окончания — от даты окончания регистрации
- Дату окончания — на странице монитора в вашем формате времени
- Регистратора — имя, которое реестр возвращает для обслуживающего регистратора
- Статус регистрации — по нему определяется блокировка или снятие с делегирования
Данные берутся сначала из RDAP — современной структурированной замены WHOIS. Если у зоны нет RDAP-сервиса — так устроены .ru, .de, .cn и другие — проверка автоматически откатывается к классическому WHOIS-запросу. Выбирать между ними не нужно.
Для .com и .net WHOIS-ответ часто содержит две даты окончания: одну от реестра, другую от регистратора. Дата реестра может сдвигаться вперёд автоматически, пока счёт ещё не оплачен, поэтому PingZen всегда берёт более раннюю из двух. Монитор с поздней датой зеленел бы на домене, который на самом деле не оплачен.
Пороги срока действия
Когда монитор среагирует, решают два числа дней.
Предупреждение об истечении домена (дни) — по умолчанию 30
Как только остаётся столько дней или меньше, монитор желтеет и отправляет оповещение «Degraded». На аптайм это не влияет — домен работает, ему просто нужен платёж.
Критический порог (дни) — по умолчанию 7
Ниже него бейдж с оставшимися днями на странице монитора становится красным вместо жёлтого, а сообщение проверки помечается как CRITICAL. Статус при этом остаётся жёлтым: неистёкший домен никогда не считается аварией.
30 дней выбраны намеренно. Регистраторы выставляют счета раз в год, протухшая карта или непрочитанный счёт разбираются не за час, и ничто в продлении домена не происходит само собой, в отличие от сертификата. Если ваш регистратор надёжно продлевает автоматически — уменьшите порог; если платёж идёт через бухгалтерию — увеличьте.
Эти пороги не уменьшаются под короткие регистрации. Монитор сертификата ограничивает свои пороги сроком жизни сертификата, потому что сертификаты теперь живут считаные дни и фиксированное критическое окно в 7 дней не выключалось бы никогда. Домены продаются целыми годами, поэтому ограничивать нечего: используются ровно те числа, которые вы задали.
Что означает каждый статус
| Ситуация | Статус | Что вы получаете |
|---|---|---|
| Дней осталось больше, чем порог предупреждения | UP | Оставшиеся дни, дата окончания и регистратор на странице монитора |
| Внутри окна предупреждения | DEGRADED | Жёлтый бейдж и оповещение «Degraded» при входе в окно. Ни инцидента, ни потери аптайма |
| Внутри критического окна | DEGRADED | Тот же статус, красный бейдж с днями, сообщение проверки помечено CRITICAL |
| Дата окончания прошла | DOWN | Открывается инцидент, уходит оповещение о падении, в сообщении указана дата истечения |
Блокировка у регистратора, redemption, pending delete или домен .ru снят с делегирования | DOWN | Открывается инцидент, в сообщении — статус, который вернул реестр |
| Ответ пришёл, но даты окончания в нём нет | DEGRADED | «Could not determine domain expiration date». Регистратор при этом показывается. Инцидента нет |
| Сам запрос не удался — реестр отказал, у зоны нет ни RDAP, ни WHOIS | DOWN | Открывается инцидент, в сообщении — ошибка от реестра |
| Запрос занял больше таймаута | TIMEOUT | Считается простоем, как любой другой таймаут |
Неудачный запрос засчитывается монитору, даже если с доменом всё в порядке — проверка не смогла доказать обратное. Реестры действительно ограничивают частоту запросов и уходят на обслуживание, и это ещё одна причина держать интервал длинным.
Настройки
Домен
Сам зарегистрированный домен: example.com. Схема, путь и порт отбрасываются, поэтому вставить https://example.com/pricing тоже можно. Указывайте домен, который вы регистрировали, а не поддомен — у www.example.com и api.example.com своей записи о регистрации нет. Домены в составных зонах вроде .co.uk обрабатываются корректно.
Предупреждение об истечении домена (дни)
Когда монитор желтеет. По умолчанию 30, диапазон от 1 до 365, и никогда не меньше критического значения.
Критический порог (дни)
Когда бейдж с днями становится красным. По умолчанию 7, диапазон от 1 до 30. В форме монитора есть только поле предупреждения; критическое значение остаётся по умолчанию, пока вы не зададите его через API или инструменты MCP.
Интервал проверки
При выборе WHOIS интервал ставится в 24 часа, а таймаут — в 30 секунд. Дата регистрации меняется раз в год, так что один запрос в сутки — это уже щедро, а на частые автоматические запросы реестры отвечают ограничением частоты. Сутки — это и максимальный интервал, который допускает PingZen.
Оповещения
Degraded — то самое, ради чего всё
Подключите оповещение с триггером Degraded. Оно срабатывает в тот день, когда монитор переходит ваш порог предупреждения. Именно это сообщение спасает домен; всё, что после него, — уже аврал.
Down
Срабатывает, когда домен истёк, когда реестр сообщает о блокировке и когда запрос не удался. Вместе с ним открывается инцидент.
«Certificate Expiring» здесь не работает
Этот триггер читает даты сертификата и срабатывает только у мониторов, которые сертификат читают. Отсчёт срока домена его не использует, поэтому не ждите его на WHOIS-мониторе.
По умолчанию вы получите одно сообщение, а не ежедневное напоминание. Оповещение срабатывает на переходе в жёлтое состояние; пока монитор остаётся жёлтым, ничего не повторяется — если только у этого оповещения не включены напоминания: тогда сообщение о деградации повторяется раз в 24 часа, пока состояние не снимется. Переход из окна предупреждения в критическое сменой статуса не является, поэтому сам по себе ничего не отправляет. Поставьте порог предупреждения равным тому запасу времени, который вам реально нужен, и считайте это единственное сообщение дедлайном. Каналы и маршрутизация — в разделе оповещений.
Ключевые возможности
- Сначала RDAP, автоматический откат к WHOIS для зон без RDAP-сервиса
- Берётся более ранняя из дат реестра и регистратора, поэтому неоплаченное продление не выглядит здоровым
- Определяет блокировку у регистратора, redemption и pending delete, а также снятые с делегирования домены
.ru - Дата окончания и имя регистратора сохраняются с каждой проверкой и видны на мониторе
- Пороги предупреждения и критического уровня в днях без подстройки под срок жизни — используются заданные вами числа
- Истекающий домен — жёлтый, а не авария: без инцидента и без потери аптайма
Частые вопросы
Какие протоколы можно мониторить?
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 секунд.