Azure 活頁簿資料來源
活頁簿可以從這些資料來源擷取資料:
- 記錄
- 計量
- Azure Resource Graph
- Azure Resource Manager
- Azure 資料總管
- JSON
- 合併
- 自訂端點
- 工作負載健康狀態
- Azure 資源健康狀態
- Azure RBAC
- 變更分析
- Prometheus
記錄
使用活頁簿,您可以從下列來源查詢記錄:
- Azure 監視器記錄 (Application Insights 資源與 Log Analytics 工作區)
- 以資源為中心的資料 (活動記錄)
您可以使用 Kusto 查詢語言 (KQL) 查詢來轉換基礎資源資料,以選取可視覺化為文字、圖表或方格的結果集。
您可以輕鬆地查詢多個資源,以建立統一的豐富報告體驗。
另請參閱:記錄查詢的活頁簿最佳做法和提示
教學課程:在活頁簿中建立以資源為中心的記錄查詢
計量
Azure 資源會發出可透過活頁簿存取的計量。 您可以透過專用的控制項在活頁簿中存取計量,該控制項可讓您指定目標資源、所需計量及其匯總。 然後,您可以在圖表或方格中繪製此資料。
Azure Resource Graph
活頁簿支援使用 Azure Resource Graph 查詢資源及其中繼資料。 這項功能主要用於建立報告的自訂查詢範圍。 資源範圍會透過 Resource Graph 支援的 KQL 子集來表示,通常這對常見的使用案例來說已足夠。
若要建立使用此資料來源的查詢控制,請使用 [查詢類型] 下拉式清單,然後選取 [Azure Resource Graph]。 然後,選取 [訂閱] 以設定目標。 使用查詢控制來新增 Resource Graph KQL 子集,以選取您有興趣的資源子集。
Azure Resource Manager
Azure 活頁簿支援 Azure Resource Manager REST 作業,讓您可以查詢 management.azure.com 端點,而不需提供自己的授權標頭權杖。
若要建立使用此資料來源的查詢控制,請使用 [資料來源] 下拉式清單,然後選取 [Azure Resource Manager]。 提供適當的參數,例如 HTTP 方法、URL 路徑、標頭、URL 參數及/或本文。 Azure Resource Manager 資料來源是用來做為資料來源,以增強資料的視覺效果; 因此,它不支援 PUT
或 PATCH
作業。 資料來源支援下列 HTTP 方法,並具有這些期待和限制:
GET
- 視覺效果最常見的作業,請執行查詢,並使用 [結果設定] 索引標籤中的設定來剖析JSON
結果。GETARRAY
- 對於可能會使用 ARM 標準nextLink
或@odata.nextLink
樣式回應傳回多個「頁面」結果的 ARM API (請參閱 非同步操作、節流和分頁,此方法會針對每個nextLink
對 API 進行後續呼叫,並將這些結果合併成結果陣列。POST
- 此方法用於在 POST 主體中傳遞資訊的 API。
注意
Azure Resource Manager 資料來源僅支援傳回 200 OK
回應的結果,指出結果為同步。 不支援使用 202 ACCEPTED
非同步結果傳回非同步結果的 API,而且不支援具有結果 URL 的標頭。
Azure 資料總管
活頁簿現在支援使用功能強大的 Kusto 查詢語言,從 Azure 資料總管叢集進行查詢。 針對 [叢集名稱] 欄位,在叢集名稱後方新增區域名稱。 例如:mycluster.westeurope。
另請參閱:Azure Data Explorer 查詢最佳做法
JSON
JSON 提供者可讓您從靜態 JSON 內容建立查詢結果。 這最常用於參數中,以建立靜態值的下拉式清單參數。 簡單的 JSON 陣列或物件會自動轉換成方格資料列與資料行。 如需更具體的行為,您可以使用 [結果] 索引標籤與 JSONPath 設定來設定資料行。
注意
「請勿」在標頭、參數、本文與 URL 等欄位中包含敏感性資訊,因為所有活頁簿使用者都會看見。
此提供者支援 JSONPath。
合併
合併來自不同來源的資料可以增強深入解析的體驗。 例如,使用相關計量資料來加強作用中的警示資訊。 合併資料可讓使用者不只看到效果 (作用中警示),也會看到可能原因,例如高 CPU 使用率。 監視網域有許多這類可互相關聯的資料來源,往往對分級和診斷工作流程至關重要。
使用活頁簿,您可以查詢不同的資料來源。 活頁簿也提供簡單的控制項,可讓您用於合併或聯結資料,以提供豐富的見解。 合併控制項是達成此目的的方法。 單一合併資料來源可以在一個步驟中執行許多合併。 例如,單一合併資料來源可以合併使用 Azure Resource Graph 與 Azure 計量步驟的結果,然後使用一個查詢項目中的 Azure Resource Manager 資料來源,將該結果與另一個步驟合併。
注意
雖然隱藏的查詢和計量步驟會在合併步驟參考時執行,但是使用合併資料來源的隱藏查詢項目不會在隱藏時執行。 一步驟使用合併並嘗試透過合併資料來源參考隱藏的步驟,其在隱藏的步驟變成可見之前,將不會執行。 單一合併步驟可以一次合併許多資料來源。 合併資料來源參考另一個合併資料來源的情況很少見。
將警示資料與 Log Analytics VM 效能資料結合
下列範例將警示資料與 Log Analytics VM 效能資料結合,以取得豐富的見解方格。
使用合併控制項將 Resource Graph 與 Log Analytics 資料結合
觀看使用合併控制項將 Resource Graph 與 Log Analytics 資料結合的下列教學課程:
Workbooks 支援這些合併:
- 內部唯一聯結
- 完整內部聯結
- 完整外部聯結
- 左方外部聯結
- 右方外部聯結
- 左方半聯結
- 右方半聯結
- 左方反聯結
- 右方反聯結
- Union
- 複製資料表
合併範例
自訂端點
活頁簿支援從任何外部來源取得資料。 若您的資料位於 Azure 外部,您可以使用此資料來源類型將資料帶入活頁簿。
若要建立使用此資料來源的查詢控制,請使用 [資料來源] 下拉式清單,然後選取 [自訂端點]。 提供適當的參數,例如 HTTP 方法、URL、標頭、URL 參數,以及本文。 請確定您的資料來源支援 CORS。 否則,要求將會失敗。
為了避免在使用範本時自動呼叫不受信任的主機,您必須將使用的主機標示為受信任。 您可以選取 [Add as trusted] \(新增為受信任\),或在活頁簿設定中將其新增為受信任的主機。 這些設定將會儲存在支援 IndexDb 與 Web 背景工作角色的瀏覽器中。
此提供者支援 JSONPath。
工作負載健康情況
Azure 監視器具有可主動監視 Windows 或 Linux 客體作業系統可用性和效能的功能。 Azure 監視器會建立重要元件及其關聯性的模型、測量元件健康情況的準則,以及那些元件應在偵測到狀況不良狀況時警示您。 使用活頁簿,您可以使用此資訊來建立豐富的互動式報告。
若要建立使用此資料來源的查詢控制,請使用 [查詢類型] 下拉式清單,然後選取 [Workload Health] \(工作負載健康狀態\)。 然後選取要設定為目標的訂閱、資源群組或 VM 資源。 使用健康狀態篩選下拉式清單,為您的分析需求選取一組您有興趣的健康狀態事件。
Azure 資源健康狀態
活頁簿支援取得 Azure 資源健康狀態,並將其與其他資料來源結合,以建立豐富的互動式健康狀態報告。
若要建立使用此資料來源的查詢控制,請使用 [查詢類型] 下拉式清單,並選取 [Azure health] \(Azure 健康狀態\)。 然後選取要設定為目標的資源。 使用健康狀態篩選下拉式清單,為您的分析需求選取一組您有興趣的資源問題。
Azure RBAC
Azure 角色型存取控制 (RBAC) 提供者可讓您檢查資源的權限。 這最常用於參數中,以檢查是否已設定正確的 RBAC。 使用案例會建立參數來檢查部署權限,然後在沒有部署權限時通知使用者。
簡單的 JSON 陣列或物件會自動轉換成方格資料列與資料行,或具有 true 或 false 之 hasPermission
資料行的文字。 每個資源上的權限都會進行檢查,然後檢查 or
或 and
以取得結果。 作業或動作可以是字串或陣列。
字串:
"Microsoft.Resources/deployments/validate/action"
陣列:
["Microsoft.Resources/deployments/read","Microsoft.Resources/deployments/write","Microsoft.Resources/deployments/validate/action","Microsoft.Resources/operations/read"]
變更分析
若要使用應用程式變更分析作為資料來源來進行查詢控制,請使用 [資料來源] 下拉式清單,並選擇 [變更分析]。 然後選取單一資源。 最多可以顯示過去 14 天內的變更。 使用 [層級] 下拉式清單來篩選重要、正常與雜訊變更。 此下拉式清單支援下拉式清單類型的活頁簿參數。
Prometheus
使用 Azure 監視器適用於 Prometheus 的受管理服務您可以替 Kubernetes 叢集收集 Prometheus 計量。 若要查詢 Prometheus 計量,請從資料源下拉式清單中選取 Prometheus,然後選取計量儲存在 Azure 監視器工作區,以及 PromQL 查詢 Prometheus 查詢類型。
注意
從 Azure 監視器工作區查詢是資料平面動作,需要明確指派監視資料讀取器的角色,預設不會指派監視資料讀取器,深入了解 Azure 控件和資料平面
下一步
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應