共用方式為


從 KQL 查詢集建立啟動器警示

本文說明如何從 KQL 查詢集建立網狀架構啟動器警示。 如需詳細資訊,請參閱 什麼是啟動器。 您可以在 KQL 查詢集上使用啟動器,以兩種模式觸發通知:

  • 當排程的 KQL 查詢傳回結果時
  • 當已排程的 KQL 查詢傳回結果,其中包含符合一組已定義條件的視覺效果時。

傳送警示通知給自己,或傳送給組織中的其他人。 您可以透過電子郵件或Microsoft Teams 訊息傳送通知。

範例案例

以下是搭配 KQL 查詢使用啟動器警示的一些方式:

  • 假設您有 KQL 資料庫,並正在儲存應用程式記錄。
    • 當過去五分鐘內的任何記錄包含數據表 訊息 數據行中的字串 authorization error 時,您會收到警示。
  • 在不同的案例中,您有串流數據供不同街區的自行車使用。 系統會建立 KQL 查詢,以轉譯每個街區可用自行車數目的餅圖。
    • 當任何街區的可用自行車數目低於可接受的數位時,您會收到警示。

必要條件

重要

僅支援對 Eventhouse 內 KQL 資料庫的查詢。 如果您的 KQL 查詢集已連線到 外部 Azure 數據總管叢集,則不支援建立警示。

下列步驟說明如何在建立視覺效果的查詢上建立警示,或在未建立視覺效果的查詢上建立警示。

選擇對應至所需工作流程的索引標籤。

在 KQL 查詢集上設定警示

重要

此案例不支持時間圖 視覺效果。 從即時儀錶板建立啟動器警示中支持它們。

  1. 開啟包含 KQL 查詢集的工作區。

  2. 流覽至您的 KQL 查詢集,然後選取它以開啟。

  3. 執行傳回視覺效果的查詢。

  4. 查詢傳回結果后,請選取頂端功能區上的 [ 設定警示 ]。

    例如,下列查詢是以即時智慧教學課程中的自行車數據範例為基礎。

    TutorialTable
    | where Timestamp < ago(5m)
    | summarize NumberOfBikes=sum(No_Bikes) by Neighbourhood
    | render columnchart
    

    此查詢會傳回柱形圖,其中顯示每個街區可用的自行車數目。 使用此圖表來設定警示條件。

定義警示條件

  1. 設定查詢執行頻率的時間頻率。 預設值為五分鐘。

  2. 在 [條件]中,指定警示條件,如下所示:

    • 如果您的視覺效果沒有維度,您可以選擇要監視的特定欄位,以在條件監視數據流中的變更時,選取 [開啟每個事件]。
    • 如果您的視覺效果包含維度,您可以選取 依條件分組 的每個事件,藉由選取群組的欄位來監視數據流中的變更,以將數據分割成不同的群組
    • 在 [ 時機] 下拉式清單中,設定要評估的值。
    • 在 [ 條件 ] 下拉式清單中,設定要評估的條件。 如需詳細資訊,請參閱條件
    • 在 [ 值] 欄位中,設定要比較的值。
  3. 在 [動作],指定您想要透過電子郵件或Microsoft Teams 發出警示。 在側邊窗格中,您可以設定傳送給自己的通知。 若要將通知傳送給不同的使用者,請參閱 選擇性:在啟用者中編輯您的規則。

  4. 在 [ 儲存位置] 中,指定儲存啟動器警示的位置。 選擇現有的工作區,並將它儲存在現有的啟動器或新的工作區中。

  5. 選取 [建立] 以建立啟動器規則。

    KQL 查詢集中用於建立啟動器警示之設定警示窗格的螢幕快照。

選擇性:在啟動器中編輯您的規則

儲存啟動器時,側邊窗格會顯示項目的連結。 選取連結以在啟動器中進一步編輯。 如果您想要執行下列其中一個動作,這個步驟會很有用:

  • 將其他收件者新增至警示。
  • 變更警示的內容,以反映觸發警示的特定數據。
  • 定義比 [設定警示] 窗格中可能的警示條件更複雜的警示條件。

如需如何在啟動器中編輯規則的資訊,請參閱 建立啟動器規則

在啟動器本身中,您也可以檢視查詢結果的歷程記錄和規則啟用的歷程記錄。 如需詳細資訊,請參閱 建立啟動器規則