跳至主要内容
版本:0.4 · 現行版

連接 Azure Monitor

操作指南審閱日期:2026年10月11日
適用於:Excubius 0.4角色: 實體管理員
方案Free · Core · Pro · Enterprise部署自行託管

連接 Azure Monitor,即可把你的 Azure 資源連同其平台指標、已觸發的警報、Data Factory 執行情況和即將到期的機密帶入 Excubius。本指南說明 Azure 端的最低權限角色、如何新增數據源,以及如何透過 action group 接收警報。

開始之前​

  • 你需要在訂閱所屬的實體上擁有 Entity admin(實體管理員)角色。
  • 在 Azure 中,需要有人能夠在這些訂閱上指派角色;如果要檢查應用程式註冊到期,還需要有人能夠在 Entra ID 中授予管理員同意。
  • 功能 sources.azure_monitor 已開啟。請參閱數據源。

Excubius 讀取的內容​

Azure 的讀取透過 Azure Resource Manager、Resource Graph、Azure Monitor、Alerts Management、Data Factory、Key Vault 數據平面和 Microsoft Graph 進行。每次呼叫都是讀取;少數 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(見下文)在你的租用戶中建立這些 Data Factory,或其資源群組
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 彈性伺服器、儲存體帳戶、金鑰保存庫、Recovery Services 保存庫、Data Factory,以及網絡閘道、防火牆和負載平衡器。
  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。它只會顯示一次。

透過 action group 接收警報​

在 Hybrid 或 Webhook only 模式下:

  1. 在 Azure Monitor 中,建立一個 action group,其中的 Webhook 動作指向 Excubius 顯示的 URL,並開啟 common alert schema。
  2. 在你希望其警報出現在 Excubius 的警報規則中使用該 action group。
注意

Action group 無法加入標頭,因此 URL 中的權杖就是憑證。請保持 URL 私密,如果外洩,請在該數據源上選取 Rotate URL。

測試及同步​

  1. 在數據源頁面上,選取 Test。每次讀取都會連同其結果列出,選用的會加上標示:憑證、訂閱、清單、警報、指標、Data Factory、Key Vault 和應用程式註冊。
  2. 選取 Sync now,無須等待即可帶入資源、指標和警報。

Azure 資源會出現在該數據源的實體下,並按資源 ID 和名稱,與其他數據源中的相同伺服器配對。每個 Data Factory 都會在 Overview 上有一張卡片,並且 30 天內到期的機密會出現在 Expiry and risk 下。