连接 New Relic
连接 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
- 创建一个用户,或使用服务用户,其在该账户上的角色为 read only,例如内置的 All product read only 角色。
- 以该用户身份登录,打开 API keys 并创建类型为 User 的密钥。复制该密钥;它以
NRAK-开头。许可证密钥、浏览器密钥和引入密钥都不起作用。 - 记下账户 ID 和数据中心,US 或 EU。
Excubius 轮询只需要这个用户密钥。处于 Webhook only 模式的数据源既不需要密钥,也不需要账户 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 会随每个 webhook 一起发送它。
- 选择 Create source 并复制 webhook URL。它只显示一次。
通过 webhook 发送问题
在 Hybrid 或 Webhook only 模式下,请将 New Relic 设置为推送其问题:
-
在 New Relic 中,打开 Alerts › Destinations,并使用 Excubius 显示的 URL 添加一个 Webhook 目标。如果你设置了 webhook 机密,请添加标头
Authorization: Bearer <secret>或X-Webhook-Secret: <secret>。 -
创建一个工作流,筛选出你希望进入 Excubius 的问题,并使用以下有效负载模板通知该目标:
New Relic 的默认模板也可以使用。
-
在 activated 和 closed 时发送通知,这样警报也会在 Excubius 中关闭。
测试和同步
- 在数据源页面上,选择 Test。每次读取都会连同其结果一起列出:凭据、账户、清单和警报。
- 选择 Sync now,立即引入清单、指标和警报,而不必等待。
主机显示为资源,并与来自其他数据源的相同服务器匹配。APM 服务显示为 Application (APM) 资源,监视器显示为 Synthetic monitor 资源,并带有它们的检查。未关闭的问题会出现在 Alert inbox 中,并带有指向 New Relic 的链接。
选择模式
| 模式 | 你会获得 |
|---|---|
| Hybrid | 通过 webhook 立即获得问题;通过轮询获得清单和指标;还有一次核对,用于关闭在 webhook 丢失期间已在 New Relic 中关闭的内容 |
| Polling | 所有内容都通过轮询获得。问题会在警报间隔内出现,默认为 5 分钟 |
| Webhook only | 只有问题,没有清单或指标,也不存储密钥 |