Документация
Полное руководство по настройке мониторинга сайтов с PingZen. Документация API, примеры кода и лучшие практики.
DNS-монитор запрашивает у одного имени одну запись и сообщает, что вернулось. Он отвечает на два вопроса: резолвится ли имя вообще и резолвится ли оно в то значение, которое вы ожидаете. О сервисе за этим именем он не говорит ничего — это другой монитор.
Для чего подходит
Имя перестало резолвиться
Удалённая зона, сломанное делегирование после переезда к другому регистратору, замолчавшие nameserver'ы. Серверы живы, а достучаться до них не может никто. DNS-монитор называет причину одной строкой вместо часа догадок.
Запись изменилась без вашего ведома
Запишите ожидаемое значение — и монитор упадёт в тот момент, когда ответ перестанет его содержать. Так ловятся угнанный или взломанный аккаунт, коллега, правивший не ту зону, наполовину откатившийся переезд и CDN или SaaS-провайдер, который перевёл ваше имя на новый адрес.
Записи, на которые не смотрят, пока не сломается
MX, по которым ходит ваша почта, TXT с SPF, DKIM или подтверждением домена у провайдера, NS с делегированием, CNAME на CDN. Об их пропаже никто не предупреждает — почта просто перестаёт доходить, а сервис тихо сообщает, что домен больше не подтверждён.
Сколько занимает резолв
Каждая проверка записывает время ответа. Медленный DNS добавляется к началу каждого запроса посетителя и при этом не виден в серверных замерах.
Для чего не подходит
DNS-монитор читает запись. Он никогда не подключается к тому, на что она указывает:
| Что нужно узнать | Что использовать |
|---|---|
| Скоро ли истекает регистрация домена? Это самая частая путаница. Записи прекрасно резолвятся вплоть до дня, когда реестр заберёт домен — DNS-монитор не предупредит заранее, он упадёт вместе со всем остальным | Монитор WHOIS |
| Работает ли сайт за этим именем? A-запись резолвится идеально, пока веб-сервер отдаёт всем 502 | Монитор HTTP / HTTPS |
| Принимает ли почтовый сервер письма? MX-запись говорит только о том, какой хост должен их принимать | Монитор SMTP на хост, указанный в MX |
| Нет ли моего IP или домена в спам-блэклистах? Блэклисты публикуются через DNS, но проверка означает опрос десятков провайдеров, а не одной записи | Монитор DNSBL |
| Доступен ли хост? Имя может резолвиться в адрес, который ни на что не отвечает | Монитор Ping |
| Жив ли конкретный nameserver и согласны ли все между собой? Монитор спрашивает резолвер, а не каждый ваш авторитативный сервер по очереди | Монитор UDP или TCP на порт 53 каждого nameserver'а: он скажет, что сервер отвечает, но не что именно он отвечает |
Что делает каждая проверка
Один запрос выбранного вами типа записи через публичный рекурсивный резолвер, настроенный в PingZen. Проверка записывает:
- Полученные значения — весь список вернувшихся записей, он сохраняется с каждым результатом проверки
- Время резолва — сколько занял ответ, в миллисекундах
Поскольку запрос идёт через рекурсивный резолвер, вы видите то, что видит публичный интернет, вместе с закэшированными ответами. Запись, изменённая минуту назад, может появиться здесь только после истечения старого TTL. Для монитора это обычно и нужно: он показывает ответ, который на самом деле получают ваши пользователи.
Типы записей
| Тип | Что им смотрят |
|---|---|
A | IPv4-адрес, на который указывает имя. Значение по умолчанию и правильный выбор, если вы не уверены |
AAAA | IPv6-адрес. Отдельный монитор имеет смысл: AAAA может отсутствовать или быть неверной, пока с A всё в порядке |
CNAME | Цель алиаса — CDN, балансировщик, хост SaaS-сервиса |
MX | Маршрутизация почты. Значения записываются вместе с приоритетом, например 10 mail.example.com. |
TXT | SPF, DKIM, DMARC и строки подтверждения домена. Запись, разбитая на несколько строк, записывается склеенной через пробел |
NS | Делегирование — какие nameserver'ы должны быть авторитативными для зоны |
SOA | Собственная запись зоны. Чаще всего используется как доказательство, что зона существует и отдаётся |
PTR | Обратный резолв адреса. По нему почтовые серверы судят об отправителе |
Этими восемью список исчерпывается. Любой другой тип — SRV, CAA и прочие — отклоняется, и проверка завершается ошибкой с сообщением о неподдерживаемом типе записи.
Ожидаемые значения
Если список ожидаемых значений пуст, монитор спрашивает только о том, резолвится ли имя. Если он заполнен, каждое перечисленное значение обязано оказаться в ответе.
- Сравнение точное, посимвольное, значение к значению. Это не поиск подстроки и не шаблон.
- В ответе может быть больше записей, чем вы перечислили. Две A-записи при одной ожидаемой — это нормально, важно лишь наличие перечисленной.
- Если какого-то значения нет, проверка падает, а сообщение об ошибке показывает и чего не хватило, и что пришло вместо этого — новое значение видно прямо на странице монитора.
- Полученные значения записываются и при упавшей проверке, так же как при успешной.
- Имена в ответах
CNAME,NSиMXприходят с точкой на конце —mail.example.com.— так их и пишите. У значенийMXвпереди ещё стоит приоритет. - До 100 значений на монитор.
Ожидаемые значения задаются в форме монитора через запятую, а также через API или инструменты MCP.
Логика статусов
DNS-монитор либо работает, либо нет. Состояния деградации у него нет, порога на медленный ответ тоже: долгий, но правильный ответ — это по-прежнему UP.
| Результат | Статус |
|---|---|
| Запись вернулась, ожидаемые значения не заданы | UP |
| Запись вернулась и содержит все ожидаемые значения | UP |
| В ответе не хватает ожидаемого значения | DOWN |
| Имя не существует (NXDOMAIN) | DOWN |
| Имя есть, но записи такого типа у него нет | DOWN |
| Ни один nameserver не ответил или подвела сеть | DOWN |
| Ответ не пришёл до истечения таймаута | TIMEOUT |
У каждой неудачи своя формулировка — «домен не найден», «запись MX не найдена», «ожидаемые значения не найдены» — так что на странице монитора видно, что именно произошло.
Один неудачный резолв — ещё не авария: как и у любого монитора, DOWN подтверждается только после нескольких подряд упавших проверок, по умолчанию трёх. Что происходит дальше, описано в разделе инциденты.
Настройки
Имя
Имя для запроса, с префиксом dns:// или без него: example.com и dns://example.com работают одинаково. Для поддомена пишите полное имя — mail.example.com, а не mail. Без порта.
Тип записи
Один из восьми типов выше. По умолчанию A. Один монитор спрашивает один тип, поэтому следить и за A-записью, и за MX того же домена — это два монитора.
Ожидаемые значения
Необязательно. Каждое перечисленное значение должно быть в ответе, иначе проверка падает. Пустой список означает «подойдёт любой ответ». До 100 значений.
Интервал проверки
По умолчанию 60 секунд. Записи меняются редко, так что более длинный интервал обычно ничего не теряет — если только смысл монитора не в том, чтобы быстро поймать несанкционированное изменение.
Таймаут
По умолчанию 5 секунд. У PingZen есть и собственный потолок на DNS-запросы, и проверка берёт меньшее из двух значений.
Какой резолвер используется
Запросы идут через публичный рекурсивный резолвер, настроенный в PingZen. Выбрать nameserver для конкретного монитора нельзя — в форме есть поле «DNS-сервер», но проверка его пока не использует.
Ключевые возможности
- Восемь типов записей: A, AAAA, CNAME, MX, TXT, NS, SOA и PTR
- Необязательные ожидаемые значения, и при ошибке видно и чего не хватило, и что пришло
- Полученные значения и время резолва записываются при каждой проверке, успешной и упавшей
- Своя причина для каждого способа не получить ответ вместо плоского «упало»
- Показывает ответ публичного резолвера, то есть тот ответ, который получают ваши пользователи
Частые вопросы
Какие протоколы можно мониторить?
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 секунд.