NTP проверки с помощью Proto Observability

Обновлено 15.10.2026
Позволяет отследить, если время на хосте отклоняется от значений, полученных с NTP сервера.

Описание

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. Проверьте синхронизацию времени на нём.