共用方式為


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

本文說明如何從 KQL 查詢集建立 Fabric Activator 警示。 Microsoft Fabric 中的 Fabric Activator 允許你在資料串流中偵測到模式或狀況時採取行動。 如需詳細資訊,請參閱 什麼是啟動器

你可以設定 Activator 根據 KQL 查詢集的結果在兩種情境下觸發通知:

  • 排程時 KQL 查詢會回傳結果。
  • 當 KQL 排程查詢時,會回傳符合特定條件的視覺化結果。

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

範例案例

以下是一些你可以在 KQL 查詢中使用 Activator 警示的範例:

  • 監控應用程式日誌是否有錯誤:假設你有一個 KQL 資料庫儲存應用程式日誌。 你可以設定警示,提醒你過去五分鐘內的任何紀錄是否包含authorization error欄中的字串

  • 追蹤社區內可用的自行車:想像你有不同社區可用自行車的串流數據。 你建立一個 KQL 查詢,來呈現一個圓餅圖,顯示每個社區可用的自行車數量。 您可以設定警示,當任何社區的可用自行車數量低於指定門檻時通知您。

必要條件

重要

  • 僅支援對 Eventhouse 內 KQL 資料庫的查詢。 如果您的 KQL 查詢集已連線到 外部 Azure 資料總管叢集,則不支援建立警示。
  • 警示規則對 Eventhouse 的影響取決於查詢的複雜性。 簡單的查詢和聚合是輕量級的,而聯結、轉換和排序則更耗用資源。 如果查詢每 1 或 5 分鐘執行一次,它會有效地將 Eventhouse 保持在 永遠開啟 狀態。 如果沒有查詢或擷取超過 5 分鐘,Eventhouse 可能會閒置,從而降低成本。 如需詳細資訊,請參閱 Eventhouse 運作時間

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

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

在 KQL 查詢集上設定警示

重要

此案例不支援時間表視覺效果。 在從 Real-Time 儀表板建立啟動器警示功能中,它們獲得支援。

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

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

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

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

    頂部功能區中設定警報按鈕的截圖。

定義警示條件

在出現的 「新增規則 」側窗格中,請依照以下步驟定義您的警示條件:

  1. 細節 區塊,提供你的啟動器警示規則名稱。

    新增規則側窗格中細節區塊的截圖。

  2. 監控 區段,設定查詢執行的時間頻率。 預設值是 5 分鐘。

    新增規則側窗格中監視器區塊的截圖。

  3. 條件 區塊中,請指定您的警示條件如下:

    新增規則側窗格中條件區塊的截圖。

    • 如果您的視覺效果沒有維度,您可以選擇要監視的特定欄位,以在條件監視數據流中的變更時,選取 [開啟每個事件]。
    • 在 [ 時機] 下拉式清單中,設定要評估的值。
    • 在 [ 條件 ] 下拉式清單中,設定要評估的條件。 如需詳細資訊,請參閱條件
    • 「發生 」欄位中,設定該條件必須達成的次數,才能觸發警報。
  4. 動作 區塊中,選擇以下動作之一:

    • 發送電子郵件通知

      1. 針對 [選取動作],選取 [傳送電子郵件]。
      2. 對於 收件人,請輸入收件人的電子郵件地址,或使用下拉選單選擇一個值為電子郵件地址的屬性。 預設情況下,您的電子郵件地址會被填入此處。
      3. 請在「主旨」欄位輸入電子郵件通知的主旨。
      4. 對於 標題,請輸入電子郵件通知的標題。
      5. 關於 備註,請輸入備註以接收電子郵件通知。

        備註

        輸入主旨、標題或註釋時,您可以輸入 @ 或選取文字方塊旁的按鈕來參考資料中的屬性。 例如: @BikepointID

      6. 情境中,從下拉選單中選擇你想包含在電子郵件通知中的數值。

      新增規則面板中「發送電子郵件通知」區塊的截圖。

    • 發送 Microsoft Teams 通知:向自己發送 Microsoft Teams 訊息。 你可以自訂標題和訊息內容。

      1. 選擇 動作時,請選擇 團隊 ——>訊息給個人群組聊天訊息頻道貼文
      2. 根據你的選擇,請依照以下步驟之一進行:
        • 如果您選取 [訊息給個人] 選項,請輸入收件者的 電子郵件地址 ,或使用下拉式清單來選取值為電子郵件地址的屬性。 滿足條件時,將向指定的個人發送電子郵件。
        • 如果您選取了 群組聊天訊息 選項,請從下拉式清單中選取 群組聊天 。 滿足條件後,將向群聊發布一條消息。
        • 如果你選擇了 頻道貼文 選項,請從下拉選單中選擇 隊伍頻道 。 當條件達成時,訊息會被發布到所選頻道。
      3. 對於 標題,請輸入 Teams 通知的標題。
      4. 關於 備註,請輸入 Teams 通知的備註。

        備註

        輸入主旨、標題或註釋時,您可以輸入 @ 或選取文字方塊旁的按鈕來參考資料中的屬性。 例如: @BikepointID

      5. 情境中,從下拉選單中選擇你想包含在 Teams 通知中的數值。

      「新增規則」側窗格中「發送 Microsoft Teams 通知」區塊的截圖。

    • 執行 Fabric 活動:要設定警報以在條件達成時啟動 Fabric 管線、Spark 工作或筆記本,請依照以下步驟操作:

      1. 選擇動作時,請選擇執行管線執行 Spark 工作執行 Notebook執行函式(預覽)
      2. 在選擇要執行的 Fabric 項目時,從清單中選擇 Fabric 項目(管線、筆記本、Spark 作業或函式)。
      3. 選擇新增參數,並指定 Fabric 項目的參數名稱及值。 您可以新增多個參數。 你可以透過輸入 @ 或選擇文字框旁的按鈕來傳遞警報資料中的參數。 例如: @BikepointID 「新增規則」側窗格中「Fabric 活動的執行」區段的截圖。
    • 自訂動作:要設定警報在條件達成時呼叫自訂動作,請依照以下步驟操作:

      1. 選擇動作時,請選擇建立自訂動作

        新增規則側窗格中「建立自訂動作」區塊的截圖。

      2. 如同動作部分提到的,先建立規則,然後依照 觸發自訂動作(Power Automate 流程)的步驟完成自訂動作設定。

      3. 建立自訂動作後,在規則的 定義 窗格中,從 動作 下拉選單中選擇你建立的自訂動作。

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

    新增規則側窗格中儲存位置區塊的截圖。

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

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

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

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

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

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