NTP проверки с помощью Proto Observability
Описание
NTP-проверка сравнивает системное время хоста с временем NTP-серверов и отправляет величину расхождения. Неточное время на хосте приводит к смещению метрик и трейсов на графиках, ошибкам сопоставления событий между хостами и проблемам с TLS и аутентификацией, поэтому расхождение стоит контролировать на всех хостах.
Установка
Проверка входит в поставку Агента Proto Observability и включена по умолчанию: в каталоге conf.d/ntp.d/ есть файл conf.yaml.default. Отдельная установка не требуется.
По умолчанию проверка выполняется раз в 15 минут и опрашивает публичный пул 0.ru.pool.ntp.org – 3.ru.pool.ntp.org. Если хост работает в облаке с собственным NTP-сервисом, агент использует NTP-сервер облака, а при его недоступности — тот же публичный пул.
Если доступа к публичным NTP-серверам из сети нет, укажите внутренние NTP-серверы организации (см. Конфигурация).
Конфигурация
Чтобы изменить настройки, скопируйте conf.d/ntp.d/conf.yaml.default в conf.d/ntp.d/conf.yaml в каталоге конфигурации Агента и отредактируйте копию. Файл conf.yaml.default перезаписывается при обновлении Агента.
Пример с внутренними NTP-серверами:
init_config:
instances:
- hosts:
- ntp1.corp.local
- ntp2.corp.local
offset_threshold: 5
Пример, в котором агент берёт серверы из настроек времени самого хоста:
init_config:
instances:
- use_local_defined_servers: true
Чтобы отключить проверку, удалите или переименуйте файл conf.yaml.default (и conf.yaml, если он создан) в каталоге conf.d/ntp.d/.
Настройки и их описание
| Настройка | Описание |
|---|---|
hosts | Список NTP-серверов. Агент опрашивает все и использует медиану расхождений. По умолчанию — NTP-сервер облачной платформы, если она определена, иначе 0.ru.pool.ntp.org – 3.ru.pool.ntp.org. |
host | Один NTP-сервер (имя или IP-адрес) вместо списка hosts. |
use_local_defined_servers | По умолчанию false. Если true, используются NTP-серверы из настроек хоста: на Linux — из /etc/ntp.conf, /etc/xntp.conf, /etc/chrony.conf, /etc/chrony/chrony.conf, /etc/ntpd.conf, /etc/openntpd/ntpd.conf; на Windows — из параметра реестра HKLM\SYSTEM\CurrentControlSet\Services\W32Time\Parameters\NtpServer. |
port | Порт NTP-сервера (по умолчанию 123, UDP). |
version | Версия протокола NTP (по умолчанию 3). |
timeout | Таймаут ответа сервера в секундах (по умолчанию 5). |
offset_threshold | Порог расхождения в секундах, выше которого сервисная проверка переходит в статус critical (по умолчанию 60). |
min_collection_interval | Интервал проверки в секундах (по умолчанию 900). Не уменьшайте его для публичных NTP-серверов: частые запросы нарушают правила пула и могут привести к блокировке. |
Общие параметры (tags, service) описаны на странице Общие параметры интеграций.
Метрики
ntp_offset— расхождение времени хоста с NTP-серверами (секунды). Положительное значение — часы хоста отстают, отрицательное — спешат.ntp_intake_offset— расхождение времени хоста со временем ProtoOBP Backend, вычисленное по ответам бэкенда на отправку данных (секунды). Отправляется, даже если NTP-серверы недоступны.
Сервисные проверки
ntp.in_sync
Сохраняется как метрика ntp_in_sync со значением статуса: 0 — ok, 2 — critical, 3 — unknown.
- ok — расхождение не превышает
offset_threshold; - critical — расхождение больше
offset_threshold; - unknown — ни один NTP-сервер не ответил.
Проверка работоспособности
Запустите команду статуса Агента и убедитесь, что в разделе Collector есть ntp без ошибок.
Пример для Linux:
sudo protoobp-agent status
sudo protoobp-agent check ntp
Команды для других платформ — на странице Команды и проверка работы.
Устранение неполадок
- Статус
unknownи ошибкаfailed to get clock offset from any ntp hostв журнале Агента — NTP-серверы недоступны. Проверьте, что из сети хоста разрешён исходящий UDP-трафик на порт123к указанным серверам, или укажите внутренние NTP-серверы вhosts. - Большое значение
ntp_offset— на хосте не настроена или не работает синхронизация времени (chronyd,ntpd,systemd-timesyncd, служба времени Windows). Настройте синхронизацию с теми же серверами, что указаны в проверке. ntp_offsetблизко к нулю, аntp_intake_offsetвелико — расходится время на сервере ProtoOBP Backend. Проверьте синхронизацию времени на нём.