本文說明如何從 KQL 查詢集建立 Fabric Activator 警示。 Microsoft Fabric 中的 Fabric Activator 允許你在資料串流中偵測到模式或狀況時採取行動。 如需詳細資訊,請參閱 什麼是啟動器。
你可以設定 Activator 根據 KQL 查詢集的結果在兩種情境下觸發通知:
- 排程時 KQL 查詢會回傳結果。
- 當 KQL 排程查詢時,會回傳符合特定條件的視覺化結果。
傳送警示通知給自己,或傳送給組織中的其他人。 您可以設定透過電子郵件或 Microsoft Teams 訊息傳送的通知。
範例案例
以下是一些你可以在 KQL 查詢中使用 Activator 警示的範例:
監控應用程式日誌是否有錯誤:假設你有一個 KQL 資料庫儲存應用程式日誌。 你可以設定警示,提醒你過去五分鐘內的任何紀錄是否包含
authorization error欄中的字串。追蹤社區內可用的自行車:想像你有不同社區可用自行車的串流數據。 你建立一個 KQL 查詢,來呈現一個圓餅圖,顯示每個社區可用的自行車數量。 您可以設定警示,當任何社區的可用自行車數量低於指定門檻時通知您。
必要條件
- 已啟用Microsoft網狀架構 容量的 工作區。
- 一個包含資料的 KQL 資料庫 。
- 線上至 KQL 資料庫的 KQL 查詢集。 如需詳細資訊,請參閱 在 KQL 查詢集中查詢數據。
重要
- 僅支援對 Eventhouse 內 KQL 資料庫的查詢。 如果您的 KQL 查詢集已連線到 外部 Azure 資料總管叢集,則不支援建立警示。
- 警示規則對 Eventhouse 的影響取決於查詢的複雜性。 簡單的查詢和聚合是輕量級的,而聯結、轉換和排序則更耗用資源。 如果查詢每 1 或 5 分鐘執行一次,它會有效地將 Eventhouse 保持在 永遠開啟 狀態。 如果沒有查詢或擷取超過 5 分鐘,Eventhouse 可能會閒置,從而降低成本。 如需詳細資訊,請參閱 Eventhouse 運作時間。
下列步驟說明如何在建立視覺效果的查詢上建立警示,或在未建立視覺效果的查詢上建立警示。
選擇對應至所需工作流程的索引標籤。
在 KQL 查詢集上設定警示
重要
此案例不支援時間表視覺效果。 在從 Real-Time 儀表板建立啟動器警示功能中,它們獲得支援。
定義警示條件
在出現的 「新增規則 」側窗格中,請依照以下步驟定義您的警示條件:
在 細節 區塊,提供你的啟動器警示規則名稱。
在 監控 區段,設定查詢執行的時間頻率。 預設值是 5 分鐘。
在 條件 區塊中,請指定您的警示條件如下:
- 如果您的視覺效果沒有維度,您可以選擇要監視的特定欄位,以在條件監視數據流中的變更時,選取 [開啟每個事件]。
- 在 [ 時機] 下拉式清單中,設定要評估的值。
- 在 [ 條件 ] 下拉式清單中,設定要評估的條件。 如需詳細資訊,請參閱條件。
- 在 「發生 」欄位中,設定該條件必須達成的次數,才能觸發警報。
在 動作 區塊中,選擇以下動作之一:
發送電子郵件通知:
- 針對 [選取動作],選取 [傳送電子郵件]。
- 對於 收件人,請輸入收件人的電子郵件地址,或使用下拉選單選擇一個值為電子郵件地址的屬性。 預設情況下,您的電子郵件地址會被填入此處。
- 請在「主旨」欄位輸入電子郵件通知的主旨。
- 對於 標題,請輸入電子郵件通知的標題。
- 關於 備註,請輸入備註以接收電子郵件通知。
備註
輸入主旨、標題或註釋時,您可以輸入
@或選取文字方塊旁的按鈕來參考資料中的屬性。 例如:@BikepointID。 - 在 情境中,從下拉選單中選擇你想包含在電子郵件通知中的數值。
發送 Microsoft Teams 通知:向自己發送 Microsoft Teams 訊息。 你可以自訂標題和訊息內容。
- 選擇 動作時,請選擇 團隊 ——>訊息給個人 、 群組聊天訊息或 頻道貼文。
- 根據你的選擇,請依照以下步驟之一進行:
- 如果您選取 [訊息給個人] 選項,請輸入收件者的 電子郵件地址 ,或使用下拉式清單來選取值為電子郵件地址的屬性。 滿足條件時,將向指定的個人發送電子郵件。
- 如果您選取了 群組聊天訊息 選項,請從下拉式清單中選取 群組聊天 。 滿足條件後,將向群聊發布一條消息。
- 如果你選擇了 頻道貼文 選項,請從下拉選單中選擇 隊伍 和 頻道 。 當條件達成時,訊息會被發布到所選頻道。
- 對於 標題,請輸入 Teams 通知的標題。
- 關於 備註,請輸入 Teams 通知的備註。
備註
輸入主旨、標題或註釋時,您可以輸入
@或選取文字方塊旁的按鈕來參考資料中的屬性。 例如:@BikepointID。 - 在 情境中,從下拉選單中選擇你想包含在 Teams 通知中的數值。
執行 Fabric 活動:要設定警報以在條件達成時啟動 Fabric 管線、Spark 工作或筆記本,請依照以下步驟操作:
- 在選擇動作時,請選擇執行管線、執行 Spark 工作、執行 Notebook或執行函式(預覽)。
- 在選擇要執行的 Fabric 項目時,從清單中選擇 Fabric 項目(管線、筆記本、Spark 作業或函式)。
- 選擇新增參數,並指定 Fabric 項目的參數名稱及值。 您可以新增多個參數。
你可以透過輸入
@或選擇文字框旁的按鈕來傳遞警報資料中的參數。 例如:@BikepointID。
自訂動作:要設定警報在條件達成時呼叫自訂動作,請依照以下步驟操作:
選擇動作時,請選擇建立自訂動作。
如同動作部分提到的,先建立規則,然後依照 觸發自訂動作(Power Automate 流程)的步驟完成自訂動作設定。
建立自訂動作後,在規則的 定義 窗格中,從 動作 下拉選單中選擇你建立的自訂動作。
在 [ 儲存位置] 中,指定儲存啟動器警示的位置。 選擇現有的工作區,並將它儲存在現有的啟動器或新的工作區中。
選取 [建立] 以建立啟動器規則。
選擇性:在啟動器中編輯您的規則
儲存啟動器時,側邊窗格會顯示項目的連結。 選取連結以在啟動器中進一步編輯。 如果您想要執行下列其中一個動作,這個步驟會很有用:
- 將其他收件者新增至警示。
- 變更警示的內容,以反映觸發警示的特定數據。
- 定義比 [設定警示] 窗格中可能的警示條件更複雜的警示條件。
如需如何在啟動器中編輯規則的資訊,請參閱 建立啟動器規則。
在啟動器本身中,您也可以檢視查詢結果的歷程記錄和規則啟用的歷程記錄。 如需詳細資訊,請參閱 建立啟動器規則。