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

Подключение New Relic

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

Подключите учетную запись 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 Relic5 минут
Alerts (оповещения)Проблемы AI (issues) в состояниях CREATED и ACTIVATED за последние 30 дней, по одному оповещению на проблему и сущность5 минут в режиме Polling; сверка каждые 15 минут в режиме Hybrid

Подготовка New Relic​

  1. Создайте пользователя или используйте служебного пользователя, у которого в учетной записи роль только для чтения, например встроенная роль All product read only.
  2. Войдя под этим пользователем, откройте API keys и создайте ключ типа User. Скопируйте ключ; он начинается с NRAK-. Ключи лицензии, браузера и приема данных не подходят.
  3. Запишите account ID и центр обработки данных: US или EU.

Для опроса Excubius нужен только этот пользовательский ключ. Источнику в режиме Webhook only не нужны ни ключ, ни account ID.

Добавление источника​

  1. Откройте Settings › Sources, выберите Add a source, а затем New Relic.
  2. В разделе General введите Name, например New Relic Лукоморье, и выберите Entity.
  3. В разделе Connection введите Account ID, Region и User API key.
  4. В разделе What to read оставьте Hosts, APM services, Synthetic monitors и Golden metrics или снимите флажки с ненужных. Без Golden metrics сущности поступают без своих метрик.
  5. При необходимости введите Entity filter — условие поиска сущностей New Relic, например tags.environment = 'production'. Используйте его, если одна учетная запись охватывает несколько клиентов.
  6. В разделе Ingest mode оставьте Hybrid (recommended).
  7. При необходимости в разделе Webhook введите Webhook secret, который New Relic будет отправлять с каждым веб-перехватчиком.
  8. Выберите Create source и скопируйте URL-адрес веб-перехватчика. Он отображается только один раз.

Отправка проблем через веб-перехватчик​

В режиме Hybrid или Webhook only настройте New Relic так, чтобы он сам отправлял свои проблемы (issues):

  1. В New Relic откройте Alerts › Destinations и добавьте получателя Webhook с URL-адресом, который показал Excubius. Если вы задали секрет веб-перехватчика, добавьте заголовок Authorization: Bearer <secret> или X-Webhook-Secret: <secret>.

  2. Создайте рабочий процесс (workflow), который отбирает нужные для Excubius проблемы и отправляет уведомления этому получателю по такому шаблону данных:

    {
    "issueId": {{ json issueId }},
    "state": {{ json state }},
    "priority": {{ json priority }},
    "title": {{ json annotations.title.[0] }},
    "issuePageUrl": {{ json issuePageUrl }},
    "triggerEvent": {{ json triggerEvent }},
    "createdAt": {{ createdAt }},
    "updatedAt": {{ updatedAt }},
    "conditionNames": {{ json accumulations.conditionName }},
    "policyNames": {{ json accumulations.policyName }},
    "entityGuids": {{ json entitiesData.ids }},
    "entityNames": {{ json entitiesData.names }}
    }

    Шаблон New Relic по умолчанию тоже подходит.

  3. Включите уведомления для событий activated и closed, чтобы оповещения закрывались и в Excubius.

Проверка и синхронизация​

  1. На странице источника выберите Test. Каждая операция чтения перечислена со своим результатом: учетные данные, учетная запись, инвентаризация и оповещения.
  2. Выберите Sync now, чтобы сразу получить инвентаризацию, метрики и оповещения, не дожидаясь расписания.

Узлы отображаются как ресурсы и сопоставляются с теми же серверами из других источников. Службы APM отображаются как ресурсы Application (APM), а мониторы — как ресурсы Synthetic monitor вместе со своими проверками. Открытые проблемы отображаются в Alert inbox со ссылкой на New Relic.

Выбор режима​

РежимЧто вы получаете
HybridПроблемы сразу через веб-перехватчик; инвентаризацию и метрики через опрос; сверку, которая закрывает то, что закрыто в New Relic, если веб-перехватчик потерялся
PollingВсе через опрос. Проблемы появляются в течение интервала для оповещений, по умолчанию 5 минут
Webhook onlyТолько проблемы, без инвентаризации и метрик, и без хранимого ключа