连接 Azure Monitor
连接 Azure Monitor,即可将你的 Azure 资源连同其平台指标、已触发的警报、Data Factory 运行和即将到期的机密一起引入 Excubius。本指南说明 Azure 端的最小权限角色、如何添加数据源,以及如何通过操作组接收警报。
开始之前
- 你需要在订阅所属的实体上拥有 Entity admin(实体管理员)角色。
- 在 Azure 中,需要有人能够在这些订阅上分配角色,并且对于应用注册到期,还要能够在 Entra ID 中授予管理员同意。
- 功能
sources.azure_monitor已打开。请参阅数据源。
Excubius 读取的内容
Excubius 通过 Azure Resource Manager、Resource Graph、Azure Monitor、Alerts Management、Data Factory、Key Vault 数据平面和 Microsoft Graph 读取 Azure。每个调用都是读取;少数 POST 请求属于查询,例如 Resource Graph 查询、管道或触发器运行查询,或集成运行时状态。
| 阶段 | 内容 | 默认间隔 |
|---|---|---|
| 清单 | 对这些订阅执行一次 Resource Graph 查询,仅限你选择的资源类型 | 15 分钟 |
| 指标 | Azure 模块的检查(平台指标和 Resource Graph 行,例如备份作业)、VPN 隧道状态,以及可分别开关的 Data Factory 检查、Key Vault 到期和应用注册机密到期 | 5 分钟 |
| 警报 | 过去 30 天内已触发的 Azure Monitor 警报,按目标资源 | Polling 模式下 5 分钟;Hybrid 模式下每 15 分钟核对一次 |
选择标识
| 标识 | 适用情形 |
|---|---|
| The server's managed identity(推荐) | Excubius 服务器运行在 Azure 中,并且其标识可以访问这些订阅。无需存储或轮换任何内容。它是虚拟机的系统分配标识,或者当 .env 文件中的 AZURE_CLIENT_ID 指定了用户分配的标识时,则是该标识 |
| A service principal | 订阅所在的租户是服务器的标识无法访问的。使用带客户端密码的应用注册;请在密码到期之前轮换 |
当 .env 文件同时设置了 AZURE_TENANT_ID、AZURE_CLIENT_ID 和 AZURE_CLIENT_SECRET 时,服务器会使用该服务主体,而不是其托管标识。
授予权限
只授予你所用选项需要的权限。角色 ID 是 Azure 内置角色的 ID。
| 用于 | 角色或权限 | 角色 ID | 范围 |
|---|---|---|---|
| 清单和警报 | Reader | acdd72a7-3385-48ef-bd42-f606fba81ae7 | 每个订阅,或一个管理组 |
| 平台指标 | Monitoring Reader | 43d0d8ad-25c7-4714-9337-8ba259a9fe05 | 同上 |
| Data Factory 运行、触发器运行、集成运行时状态 | 自定义角色 Data Factory run reader,见下文 | 在你的租户中创建 | 这些数据工厂,或其资源组 |
| Key Vault 到期 | 使用 Azure RBAC 的保管库使用 Key Vault Reader,或对机密、密钥和证书具有 List 权限的访问策略 | 21090545-7ca7-4776-b22c-e363652d74d2 | 每个保管库 |
| 应用注册到期 | Microsoft Graph 应用程序权限 Application.Read.All,并授予管理员同意 | — | 租户 |
例如,在一个订阅上为服务器的托管标识分配角色:
az role assignment create --assignee <principal-id> --role "Reader" \
--scope /subscriptions/<subscription-id>
az role assignment create --assignee <principal-id> --role "Monitoring Reader" \
--scope /subscriptions/<subscription-id>
Data Factory 的只读角色
Data Factory 将其运行历史记录公开为 actions(操作)。Reader 不包含这些操作,而内置的 Data Factory Contributor 会在授予这些操作的同时授予写入权限。自定义角色可以保持只读。将以下内容保存为 data-factory-run-reader.json:
{
"Name": "Data Factory run reader",
"Description": "Read Data Factory pipelines, triggers, runs and integration runtime status.",
"Actions": [
"Microsoft.DataFactory/factories/read",
"Microsoft.DataFactory/factories/pipelines/read",
"Microsoft.DataFactory/factories/triggers/read",
"Microsoft.DataFactory/factories/integrationruntimes/read",
"Microsoft.DataFactory/factories/querypipelineruns/action",
"Microsoft.DataFactory/factories/querytriggerruns/action",
"Microsoft.DataFactory/factories/integrationruntimes/getstatus/action"
],
"NotActions": [],
"AssignableScopes": ["/subscriptions/<subscription-id>"]
}
然后创建并分配它:
az role definition create --role-definition data-factory-run-reader.json
az role assignment create --assignee <principal-id> --role "Data Factory run reader" \
--scope /subscriptions/<subscription-id>/resourceGroups/<resource-group>
没有这个角色,其他所有功能仍然正常工作,Test 会把 Data Factory 列为失败的可选权限。
添加数据源
- 打开 Settings › Sources,选择 Add a source 并选择 Azure Monitor。
- 在 General 下,输入 Name 并选择 Entity。
- 在 Identity 下,选择 The server's managed identity 或 A service principal。对于服务主体,请输入 Tenant ID、Client ID 和 Client secret。
- 在 Subscriptions 下,输入订阅 ID(每行一个),或留空以读取标识可以读取的每个订阅。通过列出订阅,可以将一个租户拆分给多个客户实体。
- 在 Resource types 下,保留你需要的类型:虚拟机、Azure SQL 数据库、SQL 托管实例、PostgreSQL 灵活服务器、存储账户、密钥保管库、恢复服务保管库、数据工厂,以及网络网关、防火墙和负载均衡器。
- 选择要读取的内容:Platform metrics、Fired alerts 和 Data Factory runs 默认开启;Key Vault secret expiry 和 App registration secret expiry 在你授予其权限之前保持关闭。
- 设置 Time zone,Data Factory 摘要中的“今天”从该时区开始,例如
America/Santo_Domingo。 - 在 Ingest mode 下,如果你的警报规则可以访问 Excubius 服务器,请选择 Hybrid (recommended),否则选择 Polling。
- 选择 Create source 并复制 webhook URL。它只显示一次。
通过操作组接收警报
在 Hybrid 或 Webhook only 模式下:
- 在 Azure Monitor 中,创建一个 action group,其中的 Webhook 操作指向 Excubius 显示的 URL,并打开 common alert schema。
- 在你希望其警报进入 Excubius 的警报规则中使用该操作组。
操作组无法添加标头,因此 URL 中的令牌就是凭据。请保密该 URL,如果它泄漏,请在数据源上选择 Rotate URL。
测试和同步
- 在数据源页面上,选择 Test。每次读取都会连同其结果一起列出,并标出可选项:凭据、订阅、清单、警报、指标、Data Factory、Key Vault 和应用注册。
- 选择 Sync now,立即引入资源、指标和警报,而不必等待。
Azure 资源出现在数据源的实体下,并通过资源 ID 和名称与来自其他数据源的相同服务器匹配。每个数据工厂在 Overview 上有一张卡片,30 天内到期的机密会出现在 Expiry and risk 下。