Перейти к основному содержимому
Версия: 0.4 · текущая

Режимы приема

КонцепцияПроверено 11 октября 2026 г.
Область применения:Excubius 0.4Роли: Администратор сущности
ПланыFree · Core · Pro · EnterpriseРазвертываниеСамостоятельное размещение

Каждый источник, например New Relic, NinjaOne или Azure Monitor, передает данные в Excubius в одном из трех режимов: Polling (опрос), Webhook only (только веб-перехватчик) или Hybrid (гибридный). Режим определяет, как быстро приходят оповещения, нужны ли Excubius учетные данные для источника и получает ли он, помимо оповещений, инвентаризацию и метрики. В этой статье описан каждый режим и случаи, когда он подходит.

Три режима​

РежимКак работаетПреимуществаНедостаткиПодходит, когда
PollingСборщик по расписанию запрашивает у API источника инвентаризацию, метрики и оповещения, используя учетные данные только для чтенияИзвне ничего не поступает. После простоя данные догоняются. Вы получаете инвентаризацию и метрикиОповещения появляются в пределах интервала опроса. Расходуется квота APIИсточник не может обратиться к этому серверу: нет общедоступного адреса или входящий трафик запрещен
Webhook onlyИсточник отправляет свои оповещения на URL-адрес веб-перехватчика. Ничего не опрашивается, учетные данные не хранятсяОповещения приходят сразу. Учетные данные API вообще не нужныНет инвентаризации и метрик. Оповещения, отправленные, пока этот сервер не работает, теряютсяВы можете дать источнику URL-адрес, но не учетные данные API
HybridВеб-перехватчики для оповещений, а также опрос инвентаризации и метрик и периодическая сверка оповещенийМгновенно и с самовосстановлением: оповещение, закрытое в источнике, пока его веб-перехватчик был потерян, разрешается при следующей сверкеНемного больше обращений к APIИсточник может обращаться к этому серверу, и вы можете дать ему учетные данные только для чтения. Рекомендуемый вариант по умолчанию

Режим выбирается при добавлении источника в разделе Settings › Sources, и его можно изменить в любое время без перезапуска: сборщик применяет изменение в течение 30 секунд, а веб-перехватчики сверяются с режимом при каждом вызове.

Что делает каждый режим​

PollingWebhook onlyHybrid
Нужны учетные данныеДаНетДа
Инвентаризация и метрикиОпрашиваютсяНетОпрашиваются
ОповещенияОпрашиваются с интервалом оповещенийВеб-перехватчикиВеб-перехватчики со сверкой с интервалом сверки
Вызовы веб-перехватчиковОтклоняются и регистрируются в аудитеПринимаютсяПринимаются
Источник считается актуальным, покаОпросы выполняются успешноЗа последние сутки пришел веб-перехватчикОпросы выполняются успешно
TestВыполняется на сборщикеСразу отвечает на основе полученных данныхВыполняется на сборщике
Sync nowДаНетДа

Опрашиваемый источник остается актуальным, пока с последнего успешного опроса прошло не больше трех его самых коротких интервалов опроса; этот срок составляет не менее 15 минут. Источник в режиме только веб-перехватчика может показать лишь время последнего полученного сообщения, поэтому за тихий день он становится устаревшим.

Сверка​

Сверка — это полный список открытых оповещений источника. Оповещение, которого источник больше не перечисляет, разрешается в Excubius, за двумя исключениями:

  • Оповещения старше окна, за которое источник возвращает список (30 дней для проблем New Relic и оповещений Azure Monitor), разрешаются только тогда, когда об этом сообщает источник.
  • Оповещения, которые кто-то разрешил вручную в Excubius, не открываются повторно, пока источник продолжает сообщать о том же случае. Новый случай открывает новое оповещение.

Неудачный опрос ничего не разрешает, а если источник недоступен, оповещения не создаются на пустом месте: вместо этого источник помечается как устаревший и показывает ошибку.

Как защищены веб-перехватчики​

Каждая конечная точка веб-перехватчика применяет одни и те же правила независимо от источника:

  1. HTTPS и токен, который невозможно угадать. URL-адрес содержит случайный 256-битный токен, а хранится только его хэш. Полный URL-адрес показывается один раз, при создании. Кнопка Rotate URL заменяет его, и старый адрес сразу перестает работать.
  2. Необязательный общий секрет. Если задать Webhook secret, каждый вызов должен передавать его в виде Authorization: Bearer <secret>, в качестве пароля в Authorization: Basic или в заголовке X-Webhook-Secret либо X-Custom-Webhook-Secret. Группы действий Azure Monitor не умеют добавлять заголовки, поэтому для них учетными данными служит токен.
  3. Ограничения. Сервер принимает 30 вызовов веб-перехватчиков в минуту с одного IP-адреса с пиками до 20 и отклоняет тела запросов больше 512 КиБ. На неизвестный токен приходит тот же ответ, что и для несуществующего источника.
  4. Сохранение перед обработкой. Полезные данные сначала сохраняются, а затем обрабатываются в фоновом режиме. Данные, обработка которых завершилась ошибкой, хранятся вместе с ошибкой и обрабатываются повторно три раза, поэтому из-за ошибки в коде ничего не теряется. Повторная отправка того же события, распознанная по идентификатору события источника, принимается и отбрасывается.
  5. Аудит. Вызовы, отклоненные из-за того, что источник находится в режиме опроса или отключен, подсчитываются в источнике и регистрируются в аудите. Каждое изменение режима, смена URL-адреса, проверка и синхронизация записываются в журнал аудита с указанием пользователя и времени.

Полученные и пропущенные события хранятся 30 дней; раздел Settings › Sources показывает последние из них для каждого источника.

Интервалы опроса​

У каждого источника есть собственные интервалы в секундах в разделе Polling intervals. Оставьте поле пустым, чтобы использовать значение по умолчанию:

ИсточникИнвентаризацияМетрикиОповещения (опрос)Сверка оповещений (гибридный режим)
New Relic900300300900
NinjaOne900900300900
Azure Monitor900300300900

Минимальное значение — 60 секунд, а для сверки — 300. У каждой проверки тоже есть собственный интервал, поэтому на этапе метрик выполняются только те проверки, для которых подошло время; например, сроки действия в Key Vault считываются раз в час. Более короткие интервалы расходуют квоту API: ошибка rate limited у источника означает, что интервалы слишком малы.

Собственные проверки сборщика не зависят от режима: они выполняются с интервалами из каталога — от 30 секунд до 24 часов.