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

连接 Azure Monitor

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

连接 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范围
清单和警报Readeracdd72a7-3385-48ef-bd42-f606fba81ae7每个订阅,或一个管理组
平台指标Monitoring Reader43d0d8ad-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 列为失败的可选权限。

添加数据源​

  1. 打开 Settings › Sources,选择 Add a source 并选择 Azure Monitor。
  2. 在 General 下,输入 Name 并选择 Entity。
  3. 在 Identity 下,选择 The server's managed identity 或 A service principal。对于服务主体,请输入 Tenant ID、Client ID 和 Client secret。
  4. 在 Subscriptions 下,输入订阅 ID(每行一个),或留空以读取标识可以读取的每个订阅。通过列出订阅,可以将一个租户拆分给多个客户实体。
  5. 在 Resource types 下,保留你需要的类型:虚拟机、Azure SQL 数据库、SQL 托管实例、PostgreSQL 灵活服务器、存储账户、密钥保管库、恢复服务保管库、数据工厂,以及网络网关、防火墙和负载均衡器。
  6. 选择要读取的内容:Platform metrics、Fired alerts 和 Data Factory runs 默认开启;Key Vault secret expiry 和 App registration secret expiry 在你授予其权限之前保持关闭。
  7. 设置 Time zone,Data Factory 摘要中的“今天”从该时区开始,例如 America/Santo_Domingo。
  8. 在 Ingest mode 下,如果你的警报规则可以访问 Excubius 服务器,请选择 Hybrid (recommended),否则选择 Polling。
  9. 选择 Create source 并复制 webhook URL。它只显示一次。

通过操作组接收警报​

在 Hybrid 或 Webhook only 模式下:

  1. 在 Azure Monitor 中,创建一个 action group,其中的 Webhook 操作指向 Excubius 显示的 URL,并打开 common alert schema。
  2. 在你希望其警报进入 Excubius 的警报规则中使用该操作组。
注意

操作组无法添加标头,因此 URL 中的令牌就是凭据。请保密该 URL,如果它泄漏,请在数据源上选择 Rotate URL。

测试和同步​

  1. 在数据源页面上,选择 Test。每次读取都会连同其结果一起列出,并标出可选项:凭据、订阅、清单、警报、指标、Data Factory、Key Vault 和应用注册。
  2. 选择 Sync now,立即引入资源、指标和警报,而不必等待。

Azure 资源出现在数据源的实体下,并通过资源 ID 和名称与来自其他数据源的相同服务器匹配。每个数据工厂在 Overview 上有一张卡片,30 天内到期的机密会出现在 Expiry and risk 下。