数据源
数据源是 Excubius 从中读取数据的监视平台。添加你已有的监视系统,例如 New Relic、NinjaOne 或 Azure Monitor,它们的资源、指标和警报就会与原生采集器的检查一样,经过同样的评估、Alert inbox 和通知。Excubius 从不写入数据源:每个适配器都只读取,并且只使用每次读取所需的最小权限。
每个数据源带来什么
| 数据源 | 清单 | 为目录检查提供数据的指标 | 警报 |
|---|---|---|---|
| New Relic | 基础结构主机、APM 服务、综合监视器 | 主机 CPU、内存和磁盘(为 Windows 和 Linux 主机检查提供数据);Apdex、错误率、响应时间、吞吐量;监视器成功率和失败的位置 | AI issues,已创建或已激活 |
| NinjaOne | 你的组织的 Windows、Linux 和 macOS 设备 | 自上次联系以来的分钟数;待安装的操作系统和软件修补程序 | 已触发的条件 |
| Azure Monitor | 虚拟机、Azure SQL 数据库、托管实例、PostgreSQL 灵活服务器、存储账户、密钥保管库、恢复服务保管库、数据工厂、网络网关、防火墙和负载均衡器 | Azure 模块的平台指标和 Resource Graph 检查;Data Factory 运行、触发器和集成运行时;Key Vault 和应用注册机密的到期 | 已触发的 Azure Monitor 警报 |
| 原生采集器 | 你作为资源添加的内容 | 目录中的所有其他检查 | 来自它的检查 |
原生采集器由安装程序设置,列在数据源中只是为了显示其数据新鲜度。请参阅采集器的工作方式。
开始之前
- 你需要在数据源所属的实体上拥有 Entity admin(实体管理员)角色。
- 已打开该数据源类型。每种类型都有各自的功能开关(
sources.newrelic、sources.ninjaone、sources.azure_monitor),由超级管理员在 Settings › Instance 中设置。只要其中任何一个已打开,就会显示 Settings › Sources。 - 采集器正在运行:它轮询数据源,并运行 Test 和 Sync now。
- 对于使用 Webhook 的模式,平台可以访问 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 的模式下,页面此时会只显示一次 webhook URL:请立即将其复制到该平台中。系统只保留其令牌的哈希。如果你丢失了它,Rotate URL 会生成新的 URL,旧的 URL 会立即失效。
- 选择 Test 检查凭据以及它们可以读取的内容;系统会列出每项权限,并标出可选的权限。选择 Sync now 可立即运行清单、指标和警报,而不必等待计划时间。
数据源的数据如何与其余部分融合
- 每个对象一个资源。 New Relic、NinjaOne 和原生采集器报告的同一台主机只算一个资源。数据源首先按各自的 ID 匹配(New Relic 实体 GUID、NinjaOne 设备、Azure 资源 ID),然后在该数据源的实体及其下按完全限定名称和主机名匹配,并且只在兼容的类型之间匹配。Windows 主机、Linux 主机和 Azure 虚拟机属于同一系列。
- 目录检查,而不是供应商阈值。 供应商指标为目录检查提供数据,因此阈值、
for持续时间、实体覆盖值和收件箱的工作方式与原生检查相同。检查在数据源第一次报告它时出现在资源上。原生采集器已经运行且在过去 24 小时内成功的检查,绝不会被数据源接管;由另一个数据源提供数据的检查,或用户关闭的检查,同样不会被接管。 - 供应商警报是单独一类警报,每条供应商规则和每个资源各对应一个,并带有指向供应商的链接。当供应商表示已解决时(通过 webhook,或在完整的轮询中不再列出它们时),它们会被解决。你手动解决的警报不会被下一次轮询重新打开。资源未知的供应商警报会保持附加在数据源上。
- 消失的内容会被标记,而不是被删除。 完整的清单中不再列出的资源会标记为 missing,并保留其历史记录。
- 关闭数据源会停止其轮询并拒绝其 webhook;它报告过的内容会保留。删除数据源会删除它的警报以及只有它报告过的资源;另一个数据源或原生采集器也报告的资源会保留。
数据源页面显示什么
| 项目 | 含义 |
|---|---|
| 新鲜度 | Fresh、Stale(三个间隔内没有成功的轮询,且至少 15 分钟;对于仅 Webhook 的数据源,一天内没有收到任何内容)或 No data yet |
| Last sync、Last error | 上次运行的时间,以及上一个错误及其类型,例如 Credentials refused、Missing permission 或 Rate limited |
| Phases | Inventory(清单)、Metrics(指标)、Alerts(警报)和 Alert reconciliation(警报核对),每个阶段都显示其间隔和上次结果 |
| 计数 | 资源、缺失的资源、打开的警报和已提供数据的检查 |
| Webhook | 收到、重复、被拒绝或失败的内容,以及最近的事件 |
每个错误的含义以及如何修复:采集器错误。
本节内容
操作指南New Relic只读用户的用户密钥,以及用于 webhook 的工作流。操作指南NinjaOne仅具有 Monitoring 范围的 API 客户端。操作指南Azure Monitor服务器的托管标识或服务主体,带只读角色。