Источники
Источник — это платформа мониторинга, из которой Excubius считывает данные. Добавьте уже используемые средства мониторинга — New Relic, NinjaOne или Azure Monitor, — и их ресурсы, метрики и оповещения будут проходить ту же оценку, попадать в те же Alert inbox (входящие оповещения) и уведомления, что и проверки собственного сборщика. Excubius никогда не выполняет запись в источник: каждый адаптер только читает данные с минимальными разрешениями, необходимыми для каждой операции чтения.
Что дает каждый источник
| Источник | Инвентаризация | Метрики для проверок из каталога | Оповещения |
|---|---|---|---|
| New Relic | Узлы инфраструктуры, службы APM, синтетические мониторы | ЦП, память и диск узлов (используются в проверках узлов Windows и Linux); Apdex, частота ошибок, время отклика, пропускная способность; доля успешных выполнений мониторов и расположения со сбоями | Проблемы AI (issues), созданные или активированные |
| NinjaOne | Устройства Windows, Linux и macOS ваших организаций | Минуты с момента последнего контакта; ожидающие исправления операционной системы и программного обеспечения | Сработавшие условия |
| Azure Monitor | Виртуальные машины, базы данных Azure SQL, управляемые экземпляры, гибкие серверы PostgreSQL, учетные записи хранения, хранилища ключей, хранилища служб восстановления, фабрики данных, сетевые шлюзы, брандмауэры и подсистемы балансировки нагрузки | Метрики платформы и проверки Resource Graph модуля Azure; запуски, триггеры и среды выполнения интеграции Data Factory; сроки действия секретов Key Vault и регистраций приложений | Сработавшие оповещения Azure Monitor |
| Собственный сборщик | То, что вы добавляете как ресурсы | Все остальные проверки из каталога | Из его проверок |
Собственный сборщик настраивается при установке и указывается среди источников только для отображения актуальности его данных. См. статью Как работает сборщик.
Перед началом работы
- Вам нужна роль Entity admin (администратор сущности) в сущности, которой будет принадлежать источник.
- Вид источника включен. У каждого вида есть собственный переключатель функции (
sources.newrelic,sources.ninjaone,sources.azure_monitor), который суперадминистратор задает в разделе Settings › Instance. Раздел Settings › Sources появляется, когда включен хотя бы один из них. - Сборщик запущен: он опрашивает источники и выполняет Test и Sync now.
- Для режима с веб-перехватчиками платформа может обращаться к публичному адресу сервера Excubius.
Добавление источника
- Откройте Settings › Sources, выберите Add a source, а затем платформу.
- В разделе General введите Name и выберите Entity, которой будут принадлежать ресурсы и оповещения источника. Изменить сущность позже нельзя. Учетная запись New Relic или клиент Azure, охватывающие нескольких клиентов, обычно добавляются по одному разу для сущности каждого клиента и сужаются с помощью фильтра сущностей, организаций или подписок.
- В разделе Connection заполните поля платформы. Секреты доступны только для записи: после сохранения они отображаются как stored, их можно заменить или удалить, но нельзя прочитать.
- В разделе Ingest mode выберите Hybrid (recommended), Polling или Webhook only. Когда подходит каждый из режимов, объясняется в статье Режимы приема.
- При необходимости измените Polling intervals. Пустые поля сохраняют показанные значения по умолчанию.
- Выберите Create source. В режиме с веб-перехватчиками на странице один раз отображается webhook URL: сразу скопируйте его в платформу. Сохраняется только хэш его токена. Если вы потеряете URL-адрес, Rotate URL создаст новый, а старый сразу перестанет работать.
- Выберите Test, чтобы проверить учетные данные и то, что они позволяют читать; перечисляются все разрешения, а необязательные отмечаются. Выберите Sync now, чтобы сразу выполнить инвентаризацию, сбор метрик и оповещений, не дожидаясь расписания.
Как данные источника объединяются с остальными
- Один ресурс на один объект. Узел, о котором сообщают New Relic, NinjaOne и собственный сборщик, — это один ресурс. Источники сопоставляются сначала по собственному идентификатору (GUID сущности New Relic, устройство NinjaOne, идентификатор ресурса Azure), затем по полному доменному имени и имени узла в сущности источника и ниже, и только между совместимыми типами. Узел Windows, узел Linux и виртуальная машина Azure относятся к одному семейству.
- Проверки из каталога, а не пороговые значения поставщика. Метрики поставщика передаются в проверки из каталога, поэтому пороговые значения, длительности
for, переопределения в сущностях и входящие оповещения работают так же, как для собственных проверок. Проверка появляется у ресурса, когда источник впервые сообщает о ней. Проверку, которую уже выполняет собственный сборщик и которая была успешной за последние 24 часа, источник никогда не перехватывает; то же относится к проверке, данные для которой передает другой источник, и к проверке, отключенной пользователем. - Оповещения поставщика — это оповещения отдельного вида, по одному на правило поставщика и ресурс, со ссылкой на поставщика. Они разрешаются, когда об этом сообщает поставщик — через веб-перехватчик или когда полный опрос больше их не возвращает. Оповещение, разрешенное вручную, не открывается снова при следующем опросе. Оповещение поставщика, ресурс которого неизвестен, остается привязанным к источнику.
- Исчезнувшее отмечается, а не удаляется. Ресурс, которого больше нет в полной инвентаризации, отмечается как missing и сохраняет историю.
- Отключение источника останавливает его опрос и отклоняет его веб-перехватчики; то, о чем он сообщил, сохраняется. Удаление источника удаляет его оповещения и ресурсы, о которых сообщал только он; ресурсы, о которых также сообщает другой источник или собственный сборщик, сохраняются.
Что показывает страница источника
| Элемент | Значение |
|---|---|
| Актуальность | Fresh, Stale (нет успешного опроса за три интервала, но не менее 15 минут; для источника только с веб-перехватчиками — ничего не получено за сутки) или No data yet |
| Last sync, Last error | Время последнего запуска и последняя ошибка с ее видом, например Credentials refused, Missing permission или Rate limited |
| Phases | Inventory, Metrics, Alerts и Alert reconciliation, каждая со своим интервалом и последним результатом |
| Счетчики | Ресурсы, отсутствующие ресурсы, открытые оповещения и проверки, получающие данные |
| Webhook | Что было получено, продублировано, отклонено или завершилось ошибкой, а также последние события |
Что означает каждая ошибка и как ее исправить: Ошибки сборщика.
В этом разделе
Практическое руководствоNew RelicКлюч пользователя с правами только на чтение и рабочий процесс для веб-перехватчиков.Практическое руководствоNinjaOneКлиент API только с областью Monitoring.Практическое руководствоAzure MonitorУправляемое удостоверение сервера или субъект-служба с ролями только для чтения.