Подключение New Relic
Подключите учетную запись New Relic, чтобы передавать в Excubius узлы инфраструктуры, службы APM и синтетические мониторы вместе с их основными метриками (golden metrics) и открытыми проблемами. В этом руководстве показаны настройка с минимальными привилегиями на стороне New Relic, добавление источника и отправка проблем через веб-перехватчик.
Перед началом работы
- Вам нужна роль Entity admin (администратор сущности) в сущности, которой принадлежит учетная запись, например в сущности ООО «Лукоморье».
- В New Relic вы можете создать в учетной записи пользователя или служебного пользователя, ключ API и рабочий процесс.
- Функция
sources.newrelicвключена. См. статью Источники.
Что считывает Excubius
New Relic считывается через NerdGraph только запросами GraphQL, без мутаций.
| Этап | Что | Интервал по умолчанию |
|---|---|---|
| Inventory (инвентаризация) | Поиск сущностей в учетной записи: узлы инфраструктуры (Windows, Linux или macOS — по тегу операционной системы), приложения APM и синтетические мониторы; при необходимости результат сужается условием поиска сущностей | 15 минут |
| Metrics (метрики) | Сводки, которые возвращает тот же поиск, без NRQL, поэтому они расходуют мало квоты. ЦП, память и диск узла передаются в проверки узлов Windows и Linux; APM и синтетические мониторы — в проверки New Relic | 5 минут |
| Alerts (оповещения) | Проблемы AI (issues) в состояниях CREATED и ACTIVATED за последние 30 дней, по одному оповещению на проблему и сущность | 5 минут в режиме Polling; сверка каждые 15 минут в режиме Hybrid |
Подготовка New Relic
- Создайте пользователя или используйте служебного пользователя, у которого в учетной записи роль только для чтения, например встроенная роль All product read only.
- Войдя под этим пользователем, откройте API keys и создайте ключ типа User. Скопируйте ключ; он начинается с
NRAK-. Ключи лицензии, браузера и приема данных не подходят. - Запишите account ID и центр обработки данных: US или EU.
Для опроса Excubius нужен только этот пользовательский ключ. Источнику в режиме Webhook only не нужны ни ключ, ни account ID.
Добавление источника
- Откройте Settings › Sources, выберите Add a source, а затем New Relic.
- В разделе General введите Name, например New Relic Лукоморье, и выберите Entity.
- В разделе Connection введите Account ID, Region и User API key.
- В разделе What to read оставьте Hosts, APM services, Synthetic monitors и Golden metrics или снимите флажки с ненужных. Без Golden metrics сущности поступают без своих метрик.
- При необходимости введите Entity filter — условие поиска сущностей New Relic, например
tags.environment = 'production'. Используйте его, если одна учетная запись охватывает несколько клиентов. - В разделе Ingest mode оставьте Hybrid (recommended).
- При необходимости в разделе Webhook введите Webhook secret, который New Relic будет отправлять с каждым веб-перехватчиком.
- Выберите Create source и скопируйте URL-адрес веб-перехватчика. Он отображается только один раз.
Отправка проблем через веб-перехватчик
В режиме Hybrid или Webhook only настройте New Relic так, чтобы он сам отправлял свои проблемы (issues):
-
В New Relic откройте Alerts › Destinations и добавьте получателя Webhook с URL-адресом, который показал Excubius. Если вы задали секрет веб-перехватчика, добавьте заголовок
Authorization: Bearer <secret>илиX-Webhook-Secret: <secret>. -
Создайте рабочий процесс (workflow), который отбирает нужные для Excubius проблемы и отправляет уведомления этому получателю по такому шаблону данных:
Шаблон New Relic по умолчанию тоже подходит.
-
Включите уведомления для событий activated и closed, чтобы оповещения закрывались и в Excubius.
Проверка и синхронизация
- На странице источника выберите Test. Каждая операция чтения перечислена со своим результатом: учетные данные, учетная запись, инвентаризация и оповещения.
- Выберите Sync now, чтобы сразу получить инвентаризацию, метрики и оповещения, не дожидаясь расписания.
Узлы отображаются как ресурсы и сопоставляются с теми же серверами из других источников. Службы APM отображаются как ресурсы Application (APM), а мониторы — как ресурсы Synthetic monitor вместе со своими проверками. Открытые проблемы отображаются в Alert inbox со ссылкой на New Relic.
Выбор режима
| Режим | Что вы получаете |
|---|---|
| Hybrid | Проблемы сразу через веб-перехватчик; инвентаризацию и метрики через опрос; сверку, которая закрывает то, что закрыто в New Relic, если веб-перехватчик потерялся |
| Polling | Все через опрос. Проблемы появляются в течение интервала для оповещений, по умолчанию 5 минут |
| Webhook only | Только проблемы, без инвентаризации и метрик, и без хранимого ключа |