共用方式為

Azure 活頁簿資料來源

  • 發行項

活頁簿可以從這些資料來源擷取資料:

記錄

使用活頁簿，您可以從下列來源查詢記錄：

  • Azure 監視器記錄 (Application Insights 資源與 Log Analytics 工作區)
  • 以資源為中心的資料 (活動記錄)

您可以使用 Kusto 查詢語言 (KQL) 查詢來轉換基礎資源資料，以選取可視覺化為文字、圖表或方格的結果集。

顯示活頁簿記錄報告介面的螢幕擷取畫面。

您可以輕鬆地查詢多個資源，以建立統一的豐富報告體驗。

另請參閱：Log Analytics 查詢最佳化提示

另請參閱：記錄查詢的活頁簿最佳做法和提示

教學課程：在活頁簿中建立以資源為中心的記錄查詢

計量

Azure 資源會發出可透過活頁簿存取的計量。 您可以透過專用的控制項在活頁簿中存取計量，該控制項可讓您指定目標資源、所需計量及其匯總。 然後，您可以在圖表或方格中繪製此資料。

螢幕擷取畫面顯示 CPU 使用率的活頁簿計量圖表。

顯示活頁簿計量介面的螢幕擷取畫面。

Azure Resource Graph

活頁簿支援使用 Azure Resource Graph 查詢資源及其中繼資料。 這項功能主要用於建立報告的自訂查詢範圍。 資源範圍會透過 Resource Graph 支援的 KQL 子集來表示，通常這對常見的使用案例來說已足夠。

若要建立使用此資料來源的查詢控制，請使用 [查詢類型] 下拉式清單，然後選取 [Azure Resource Graph]。 然後，選取 [訂閱] 以設定目標。 使用查詢控制來新增 Resource Graph KQL 子集，以選取您有興趣的資源子集。

螢幕擷取畫面顯示 Azure 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。

螢幕擷取畫面顯示 Kusto 查詢視窗。

另請參閱：Azure Data Explorer 查詢最佳做法

JSON

JSON 提供者可讓您從靜態 JSON 內容建立查詢結果。 這最常用於參數中，以建立靜態值的下拉式清單參數。 簡單的 JSON 陣列或物件會自動轉換成方格資料列與資料行。 如需更具體的行為，您可以使用 [結果] 索引標籤與 JSONPath 設定來設定資料行。

注意

「請勿」在標頭、參數、本文與 URL 等欄位中包含敏感性資訊，因為所有活頁簿使用者都會看見。

此提供者支援 JSONPath。

合併

合併來自不同來源的資料可以增強深入解析的體驗。 例如，使用相關計量資料來加強作用中的警示資訊。 合併資料可讓使用者不只看到效果 (作用中警示)，也會看到可能原因，例如高 CPU 使用率。 監視網域有許多這類可互相關聯的資料來源，往往對分級和診斷工作流程至關重要。

使用活頁簿，您可以查詢不同的資料來源。 活頁簿也提供簡單的控制項，可讓您用於合併或聯結資料，以提供豐富的見解。 合併控制項是達成此目的的方法。 單一合併資料來源可以在一個步驟中執行許多合併。 例如，單一合併資料來源可以合併使用 Azure Resource Graph 與 Azure 計量步驟的結果，然後使用一個查詢項目中的 Azure Resource Manager 資料來源，將該結果與另一個步驟合併。

注意

雖然隱藏的查詢和計量步驟會在合併步驟參考時執行，但是使用合併資料來源的隱藏查詢項目不會在隱藏時執行。 一步驟使用合併並嘗試透過合併資料來源參考隱藏的步驟，其在隱藏的步驟變成可見之前，將不會執行。 單一合併步驟可以一次合併許多資料來源。 合併資料來源參考另一個合併資料來源的情況很少見。

將警示資料與 Log Analytics VM 效能資料結合

下列範例將警示資料與 Log Analytics VM 效能資料結合，以取得豐富的見解方格。

螢幕擷取畫面顯示具有合併控制項的活頁簿，該控制項會將警示與 Log Analytics 資料結合。

使用合併控制項將 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 查詢類型。

螢幕擷取畫面顯示範例 PromQL 查詢。

注意

從 Azure 監視器工作區查詢是資料平面動作，需要明確指派監視資料讀取器的角色，預設不會指派監視資料讀取器，深入了解 Azure 控件和資料平面

下一步