KQL クエリセットから Activator アラートを作成する

KQL クエリセットにアラートを設定する

1. KQL クエリセットを含むワークスペースを開きます。

2. KQL クエリセットを参照し、それを選択して開きます。

3. 視覚化を返すクエリを実行します。

4. クエリから結果が返されたら、上部のリボン [アラートの設定] を選択します。

   

アラートの条件を定義する

表示される [ ルールの追加] サイド ウィンドウで、次の手順に従ってアラートの条件を定義します。

1. [ 詳細 ] セクションで、アクティブ化アラート ルールの名前を指定します。

   

2. [ モニター ] セクションで、クエリを実行する頻度の時間の頻度を設定します。 既定値は 5 分です。

   

3. [ 条件] セクションで、アラートの条件を次のように指定します。

   

   • 視覚化にディメンションがない場合は、監視する特定のフィールドを選択して、データ ストリームの変更を監視する条件を各イベントで選択できます。
   • [タイミング] ドロップダウンで、評価する値を設定します。
   • [条件] ドロップダウンで、評価する条件を設定します。 詳細については、「条件」を参照してください。
   • [Occurrence]\( 発生 \) フィールドで、アラートがトリガーされるまでに条件を満たす必要がある回数を設定します。

4. [ アクション] セクションで、次のいずれかのアクションを選択します。

   • 電子メール通知を送信する:

     1. [ アクションの選択] で、[ 電子メールの送信] を選択します。
     2. [ 宛先] で、受信者のメール アドレスを入力するか、ドロップダウン リストを使用して、値が電子メール アドレスであるプロパティを選択します。 既定では、メール アドレスがここに入力されます。
     3. [ 件名] に、電子メール通知の件名を入力します。
     4. [ 見出し] に、メール通知の見出しを入力します。
     5. [メモ] には、電子メール通知のメモを入力します。

        注

        件名、見出し、またはメモを入力するときは、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択して、データ内のプロパティを参照できます。 たとえば、「 @BikepointID 」のように入力します。

     6. [コンテキスト] で、電子メール通知に含めるドロップダウン リストから値を選択します。

     

   • Microsoft Teams通知を送信する: Microsoft Teams メッセージを自分に送信します。 タイトルとメッセージの内容をカスタマイズできます。

     1. [アクションの選択] で、[Teams -->個人へのメッセージ または グループチャットメッセージ、または チャネル投稿] を選択します。
     2. 選択内容に応じて、次のいずれかの手順に従います。
        • [ 個人へのメッセージ ] オプションを選択した場合は、受信者の メール アドレス を入力するか、ドロップダウン リストを使用して、値が電子メール アドレスのプロパティを選択します。 条件が満たされると、指定された個人に電子メールが送信されます。
        • [グループ チャット メッセージ] オプションを選択した場合は、ドロップダウン リストからグループ チャットを選択します。 条件が満たされると、メッセージがグループ チャットに投稿されます。
        • [チャネル投稿] オプションを選択した場合は、ドロップダウン リストからチームとチャネルを選択します。 条件が満たされると、選択したチャネルにメッセージが投稿されます。
     3. [見出し] には、Teams 通知の見出しを入力します。
     4. [メモ] には、Teams 通知のメモを入力します。

        注

        件名、見出し、またはメモを入力するときは、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択して、データ内のプロパティを参照できます。 たとえば、「 @BikepointID 」のように入力します。

     5. [コンテキスト] で、Teams 通知に含めるドロップダウン リストから値を選択します。

     

   • ファブリック アクティビティの実行: 条件が満たされたときに Fabric パイプライン、Spark ジョブ、またはノートブックを起動するようにアラートを構成するには、次の手順に従います。

     1. [アクションの選択] で、[パイプラインの実行]、[Spark ジョブの実行]、[ノートブックの実行]、または [関数の実行 (プレビュー)]を選択します。
     2. 実行するファブリック項目の選択で、一覧から Fabric 項目 (パイプライン、ノートブック、Spark ジョブ、または関数) を選択します。
     3. [パラメーターの追加] を選択し、Fabric 項目のパラメーターの名前とその値を指定します。 複数のパラメーターを追加できます。 アラート データからパラメーターを渡すには、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択します。 たとえば、「 @BikepointID 」のように入力します。

   • カスタム アクション: 条件が満たされたときにカスタム アクションを呼び出すアラートを構成するには、次の手順に従います。

     1. [ アクションの選択] で、[ カスタム アクションの作成] を選択します。

        

     2. 「アクション」セクションで説明したように、最初にルールを作成してから、カスタム アクションのトリガー (Power Automate フロー) の手順に従ってカスタム アクションのセットアップを完了します。

     3. カスタム アクションを作成した後、ルールの [定義 ] ウィンドウで、[アクション] ドロップダウン リストから作成したカスタム アクション を選択します。

5. [保存場所] で、Activator アラートを保存する場所を指定します。 既存のワークスペースを選択し、既存の Activator または新しい Activator に保存します。

   

6. [作成] を選択して Activator ルールを作成します。

KQL クエリセットにアラートを設定する

1. KQL クエリセットを含むワークスペースを開きます。
2. KQL クエリセットを参照し、それを選択して開きます。
3. クエリを実行します。 Activator は、後の手順で設定する時間頻度に基づいてこのクエリの結果をチェックし、結果セットで返されたレコードごとにアラートを送信します。 たとえば、スケジュールされたクエリから 5 つのレコードが返された場合、Activator は 5 つのアラートを送信します。
4. クエリの実行が完了したら、上部のリボン [アラートの設定] を選択します。

例 1 - カウントがしきい値より大きい場合の単一の結果

たとえば、次のクエリは、過去 5 分間にテーブル内のレコード しきい値 を超える場合にアラートを返します。 クエリの最後の 2 行はキーであり、フィルターに一致するレコードの数が作成され、カウントがしきい値より大きい場合にのみ結果が返されます。

SampleTable 
| where ingestion_time() > ago (5min)
// Add any other optional filters
| count 
| where Count > threshold

例 2 - 複数の値の配列を含む単一の結果を作成する

次の例では、任意の近隣の自転車の数が指定されたしきい値を超えている場合、クエリはアラートを返します。 数値がしきい値を超えているすべての地域に対して 1 つのアラートを取得するために、クエリは、 make_list() 演算子を使用して行われる 1 つのレコード (つまり、1 つのアラート) を返すように構築されます。 しきい値に達した近隣の一覧を含むアラートを編集するには、「 オプション: アクティベーターでルールを編集する」を参照してください。

TableForReflex
| where ingestion_time() > ago (5min)
| summarize NeighborhoodCount = count() by Neighbourhood
| where NeighborhoodCount > threshold
| summarize NeighbourhoodList = make_list(Neighbourhood)

アラートの条件を定義する

表示される [ ルールの追加] サイド ウィンドウで、次の手順に従ってアラートの条件を定義します。

1. [ 詳細 ] セクションで、アクティブ化アラート ルールの名前を指定します。

   

2. [ モニター ] セクションで、クエリを実行する頻度の時間の頻度を設定します。 既定値は 5 分です。

   

3. [ 条件] セクションで、アラートの条件を次のように指定します。

   

   • 視覚化にディメンションがない場合は、監視する特定のフィールドを選択して、データ ストリームの変更を監視する条件を各イベントで選択できます。
   • [タイミング] ドロップダウンで、評価する値を設定します。
   • [条件] ドロップダウンで、評価する条件を設定します。 詳細については、「条件」を参照してください。
   • [Occurrence]\( 発生 \) フィールドで、アラートがトリガーされるまでに条件を満たす必要がある回数を設定します。

4. [ アクション] セクションで、次のいずれかのアクションを選択します。

   • 電子メール通知を送信する:

     1. [ アクションの選択] で、[ 電子メールの送信] を選択します。
     2. [ 宛先] で、受信者のメール アドレスを入力するか、ドロップダウン リストを使用して、値が電子メール アドレスであるプロパティを選択します。 既定では、メール アドレスがここに入力されます。
     3. [ 件名] に、電子メール通知の件名を入力します。
     4. [ 見出し] に、メール通知の見出しを入力します。
     5. [メモ] には、電子メール通知のメモを入力します。

        注

        件名、見出し、またはメモを入力するときは、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択して、データ内のプロパティを参照できます。 たとえば、「 @BikepointID 」のように入力します。

     6. [コンテキスト] で、電子メール通知に含めるドロップダウン リストから値を選択します。

     

   • Microsoft Teams通知を送信する: Microsoft Teams メッセージを自分に送信します。 タイトルとメッセージの内容をカスタマイズできます。

     1. [アクションの選択] で、[Teams -->個人へのメッセージ または グループチャットメッセージ、または チャネル投稿] を選択します。
     2. 選択内容に応じて、次のいずれかの手順に従います。
        • [ 個人へのメッセージ ] オプションを選択した場合は、受信者の メール アドレス を入力するか、ドロップダウン リストを使用して、値が電子メール アドレスのプロパティを選択します。 条件が満たされると、指定された個人に電子メールが送信されます。
        • [グループ チャット メッセージ] オプションを選択した場合は、ドロップダウン リストからグループ チャットを選択します。 条件が満たされると、メッセージがグループ チャットに投稿されます。
        • [チャネル投稿] オプションを選択した場合は、ドロップダウン リストからチームとチャネルを選択します。 条件が満たされると、選択したチャネルにメッセージが投稿されます。
     3. [見出し] には、Teams 通知の見出しを入力します。
     4. [メモ] には、Teams 通知のメモを入力します。

        注

        件名、見出し、またはメモを入力するときは、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択して、データ内のプロパティを参照できます。 たとえば、「 @BikepointID 」のように入力します。

     5. [コンテキスト] で、Teams 通知に含めるドロップダウン リストから値を選択します。

     

   • ファブリック アクティビティの実行: 条件が満たされたときに Fabric パイプライン、Spark ジョブ、またはノートブックを起動するようにアラートを構成するには、次の手順に従います。

     1. [アクションの選択] で、[パイプラインの実行]、[Spark ジョブの実行]、[ノートブックの実行]、または [関数の実行 (プレビュー)]を選択します。
     2. 実行するファブリック項目の選択で、一覧から Fabric 項目 (パイプライン、ノートブック、Spark ジョブ、または関数) を選択します。
     3. [パラメーターの追加] を選択し、Fabric 項目のパラメーターの名前とその値を指定します。 複数のパラメーターを追加できます。 アラート データからパラメーターを渡すには、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択します。 たとえば、「 @BikepointID 」のように入力します。

   • カスタム アクション: 条件が満たされたときにカスタム アクションを呼び出すアラートを構成するには、次の手順に従います。

     1. [ アクションの選択] で、[ カスタム アクションの作成] を選択します。

        

     2. 「アクション」セクションで説明したように、最初にルールを作成してから、カスタム アクションのトリガー (Power Automate フロー) の手順に従ってカスタム アクションのセットアップを完了します。

     3. カスタム アクションを作成した後、ルールの [定義 ] ウィンドウで、[アクション] ドロップダウン リストから作成したカスタム アクション を選択します。

5. [保存場所] で、Activator アラートを保存する場所を指定します。 既存のワークスペースを選択し、既存の Activator または新しい Activator に保存します。

1. [作成] を選択して Activator ルールを作成します。