Режимы приема
Каждый источник, например 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 секунд, а веб-перехватчики сверяются с режимом при каждом вызове.
Что делает каждый режим
| Polling | Webhook only | Hybrid | |
|---|---|---|---|
| Нужны учетные данные | Да | Нет | Да |
| Инвентаризация и метрики | Опрашиваются | Нет | Опрашиваются |
| Оповещения | Опрашиваются с интервалом оповещений | Веб-перехватчики | Веб-перехватчики со сверкой с интервалом сверки |
| Вызовы веб-перехватчиков | Отклоняются и регистрируются в аудите | Принимаются | Принимаются |
| Источник считается актуальным, пока | Опросы выполняются успешно | За последние сутки пришел веб-перехватчик | Опросы выполняются успешно |
| Test | Выполняется на сборщике | Сразу отвечает на основе полученных данных | Выполняется на сборщике |
| Sync now | Да | Нет | Да |
Опрашиваемый источник остается актуальным, пока с последнего успешного опроса прошло не больше трех его самых коротких интервалов опроса; этот срок составляет не менее 15 минут. Источник в режиме только веб-перехватчика может показать лишь время последнего полученного сообщения, поэтому за тихий день он становится устаревшим.
Сверка
Сверка — это полный список открытых оповещений источника. Оповещение, которого источник больше не перечисляет, разрешается в Excubius, за двумя исключениями:
- Оповещения старше окна, за которое источник возвращает список (30 дней для проблем New Relic и оповещений Azure Monitor), разрешаются только тогда, когда об этом сообщает источник.
- Оповещения, которые кто-то разрешил вручную в Excubius, не открываются повторно, пока источник продолжает сообщать о том же случае. Новый случай открывает новое оповещение.
Неудачный опрос ничего не разрешает, а если источник недоступен, оповещения не создаются на пустом месте: вместо этого источник помечается как устаревший и показывает ошибку.
Как защищены веб-перехватчики
Каждая конечная точка веб-перехватчика применяет одни и те же правила независимо от источника:
- HTTPS и токен, который невозможно угадать. URL-адрес содержит случайный 256-битный токен, а хранится только его хэш. Полный URL-адрес показывается один раз, при создании. Кнопка Rotate URL заменяет его, и старый адрес сразу перестает работать.
- Необязательный общий секрет. Если задать Webhook secret, каждый вызов должен передавать его в виде
Authorization: Bearer <secret>, в качестве пароля вAuthorization: Basicили в заголовкеX-Webhook-SecretлибоX-Custom-Webhook-Secret. Группы действий Azure Monitor не умеют добавлять заголовки, поэтому для них учетными данными служит токен. - Ограничения. Сервер принимает 30 вызовов веб-перехватчиков в минуту с одного IP-адреса с пиками до 20 и отклоняет тела запросов больше 512 КиБ. На неизвестный токен приходит тот же ответ, что и для несуществующего источника.
- Сохранение перед обработкой. Полезные данные сначала сохраняются, а затем обрабатываются в фоновом режиме. Данные, обработка которых завершилась ошибкой, хранятся вместе с ошибкой и обрабатываются повторно три раза, поэтому из-за ошибки в коде ничего не теряется. Повторная отправка того же события, распознанная по идентификатору события источника, принимается и отбрасывается.
- Аудит. Вызовы, отклоненные из-за того, что источник находится в режиме опроса или отключен, подсчитываются в источнике и регистрируются в аудите. Каждое изменение режима, смена URL-адреса, проверка и синхронизация записываются в журнал аудита с указанием пользователя и времени.
Полученные и пропущенные события хранятся 30 дней; раздел Settings › Sources показывает последние из них для каждого источника.
Интервалы опроса
У каждого источника есть собственные интервалы в секундах в разделе Polling intervals. Оставьте поле пустым, чтобы использовать значение по умолчанию:
| Источник | Инвентаризация | Метрики | Оповещения (опрос) | Сверка оповещений (гибридный режим) |
|---|---|---|---|---|
| New Relic | 900 | 300 | 300 | 900 |
| NinjaOne | 900 | 900 | 300 | 900 |
| Azure Monitor | 900 | 300 | 300 | 900 |
Минимальное значение — 60 секунд, а для сверки — 300. У каждой проверки тоже есть собственный интервал, поэтому на этапе метрик выполняются только те проверки, для которых подошло время; например, сроки действия в Key Vault считываются раз в час. Более короткие интервалы расходуют квоту API: ошибка rate limited у источника означает, что интервалы слишком малы.
Собственные проверки сборщика не зависят от режима: они выполняются с интервалами из каталога — от 30 секунд до 24 часов.