連接 Azure Monitor
連接 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 | 範圍 |
|---|---|---|---|
| 清單和警報 | Reader | acdd72a7-3385-48ef-bd42-f606fba81ae7 | 每個訂閱,或管理群組 |
| 平台指標 | Monitoring Reader | 43d0d8ad-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 列為失敗的選用權限。
新增數據源
- 開啟 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 彈性伺服器、儲存體帳戶、金鑰保存庫、Recovery Services 保存庫、Data Factory,以及網絡閘道、防火牆和負載平衡器。
- 選擇要讀取的內容: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。它只會顯示一次。
透過 action group 接收警報
在 Hybrid 或 Webhook only 模式下:
- 在 Azure Monitor 中,建立一個 action group,其中的 Webhook 動作指向 Excubius 顯示的 URL,並開啟 common alert schema。
- 在你希望其警報出現在 Excubius 的警報規則中使用該 action group。
Action group 無法加入標頭,因此 URL 中的權杖就是憑證。請保持 URL 私密,如果外洩,請在該數據源上選取 Rotate URL。
測試及同步
- 在數據源頁面上,選取 Test。每次讀取都會連同其結果列出,選用的會加上標示:憑證、訂閱、清單、警報、指標、Data Factory、Key Vault 和應用程式註冊。
- 選取 Sync now,無須等待即可帶入資源、指標和警報。
Azure 資源會出現在該數據源的實體下,並按資源 ID 和名稱,與其他數據源中的相同伺服器配對。每個 Data Factory 都會在 Overview 上有一張卡片,並且 30 天內到期的機密會出現在 Expiry and risk 下。