跳到主要内容
版本:0.4 · 当前版

连接 New Relic

操作指南审阅日期:2026年10月11日
适用于:Excubius 0.4角色: 实体管理员
计划Free · Core · Pro · Enterprise部署自托管

连接 New Relic 账户,即可将其基础结构主机、APM 服务和综合监视器连同黄金指标和未关闭的问题一起引入 Excubius。本指南说明 New Relic 端的最小权限设置、如何添加数据源,以及如何通过 webhook 发送问题。

开始之前​

  • 你需要在该账户所属的实体上拥有 Entity admin(实体管理员)角色,例如 高密物流。
  • 在 New Relic 中,你可以在该账户上创建用户或服务用户、API 密钥和工作流。
  • 功能 sources.newrelic 已打开。请参阅数据源。

Excubius 读取的内容​

Excubius 通过 NerdGraph 读取 New Relic,只使用 GraphQL 查询,从不使用变更。

阶段内容默认间隔
清单在账户中进行实体搜索:基础结构主机(按操作系统标记分为 Windows、Linux 或 macOS)、APM 应用程序和综合监视器,可通过实体搜索条件进一步缩小范围15 分钟
指标同一搜索返回的摘要,不使用 NRQL,因此占用的配额很少。主机 CPU、内存和磁盘为 Windows 和 Linux 主机检查提供数据;APM 和综合监视器为 New Relic 检查提供数据5 分钟
警报过去 30 天内处于 CREATED 和 ACTIVATED 状态的 AI issues,每个问题和实体对应一个警报Polling 模式下 5 分钟;Hybrid 模式下每 15 分钟核对一次

准备 New Relic​

  1. 创建一个用户,或使用服务用户,其在该账户上的角色为 read only,例如内置的 All product read only 角色。
  2. 以该用户身份登录,打开 API keys 并创建类型为 User 的密钥。复制该密钥;它以 NRAK- 开头。许可证密钥、浏览器密钥和引入密钥都不起作用。
  3. 记下账户 ID 和数据中心,US 或 EU。

Excubius 轮询只需要这个用户密钥。处于 Webhook only 模式的数据源既不需要密钥,也不需要账户 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 会随每个 webhook 一起发送它。
  8. 选择 Create source 并复制 webhook URL。它只显示一次。

通过 webhook 发送问题​

在 Hybrid 或 Webhook only 模式下,请将 New Relic 设置为推送其问题:

  1. 在 New Relic 中,打开 Alerts › Destinations,并使用 Excubius 显示的 URL 添加一个 Webhook 目标。如果你设置了 webhook 机密,请添加标头 Authorization: Bearer <secret> 或 X-Webhook-Secret: <secret>。

  2. 创建一个工作流,筛选出你希望进入 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通过 webhook 立即获得问题;通过轮询获得清单和指标;还有一次核对,用于关闭在 webhook 丢失期间已在 New Relic 中关闭的内容
Polling所有内容都通过轮询获得。问题会在警报间隔内出现,默认为 5 分钟
Webhook only只有问题,没有清单或指标,也不存储密钥