根据 KQL 查询集创建 Activator 警报

本文介绍如何从 KQL 查询集创建 Fabric 激活器警报。 Microsoft Fabric 中的 Fabric 激活器允许在数据流中检测到模式或条件时采取措施。有关详细信息，请参阅什么是 Activator。

可以在两种方案中将激活器配置为基于 KQL 查询集结果触发通知：

当计划的 KQL 查询返回结果时。
当计划的 KQL 查询返回满足特定条件的可视化结果时。

向自己或组织中的其他人发送警报通知。可以将通知配置为通过电子邮件发送或Microsoft Teams 消息。

示例方案

下面是如何将激活器警报与 KQL 查询配合使用的一些示例：

监视应用程序日志中的错误：假设你有一个存储应用程序日志的 KQL 数据库。可以将警报配置为通知你，如果过去 5 分钟内的任何记录包含authorization error列中的字符串。
跟踪街区的可用自行车：假设你有有关不同街区可用自行车的流数据。创建 KQL 查询来呈现饼图，显示每个邻里可用的自行车数。可以设置警报，以在任何街区的可用自行车数低于指定的阈值时通知你。

先决条件

具有支持 Microsoft Fabric 的容量的工作区。
包含数据的 KQL 数据库。
连接到 KQL 数据库的 KQL 查询集。有关详细信息，请参阅在 KQL 查询集中查询数据。

重要

仅支持对 Eventhouse 中的 KQL 数据库的查询。如果 KQL 查询集已连接到外部 Azure 数据资源管理器群集，则不支持创建警报。
警报规则对 Eventhouse 的影响取决于查询的复杂性。简单的查询和聚合是轻量级的，而联接、转换和排序则更加资源密集型。如果查询每 1 或 5 分钟运行一次，它将有效地使 Eventhouse 处于 始终打开 状态。如果超过 5 分钟没有查询或数据导入，Eventhouse 会进入空闲状态，从而降低成本。有关详细信息，请参阅 Eventhouse 正常运行时间。

以下步骤展示了如何针对某个创建可视化效果的查询或不创建可视化效果的查询创建警报。

选择对应于所需工作流的选项卡。

使用可视化效果
不使用可视化效果

在 KQL 查询集上设置警报

重要

此方案不支持时间表可视化效果。它们在实时仪表板中创建激活器警报时受到支持。

打开包含 KQL 查询集的工作区。
浏览到 KQL 查询集并选择它以打开。
运行一个返回可视化效果的查询。
查询返回结果后，选择顶部功能区中的“设置警报”。

定义警报条件

在显示的 “添加规则 ”侧窗格中，按照以下步骤定义警报条件：

在 “详细信息 ”部分中，提供激活器警报规则的名称。
在“监视”部分中，设置查询运行的频率。默认为 5 分钟。
在 “条件” 部分中，按如下所示指定警报条件：
- 如果可视化效果没有维度，可以选择“每次在以下情况下发生事件时”条件，通过选择要监视的特定字段来监视数据流中的变化。
- 在“当 ... 时”下拉菜单中，设置要评估的值。
- 在“条件”下拉菜单中，设置要评估的条件。有关详细信息，请参阅条件。
- 在 “事件” 字段中，设置触发警报之前必须满足条件的次数。
在操作部分中，选择以下操作之一：
- 发送电子邮件通知：
  1. 对于选择操作，请选择发送电子邮件。
  2. 对于 “收件人”，请输入接收方的电子邮件地址，或使用下拉列表选择其值为电子邮件地址的属性。默认情况下，电子邮件地址将在此处填充。
  3. 对于 “主题”，请输入电子邮件通知的主题。
  4. 对于标题，请输入电子邮件通知的标题。
  5. 对于备注，请输入电子邮件通知的备注。
    
    注释
    
    输入主题、标题或备注时，可以通过键入 @ 或选择文本框旁边的按钮来引用数据中的属性。例如，@BikepointID。
  6. 对于 上下文，请从要包含在电子邮件通知中的下拉列表中选择值。
- 发送 Microsoft Teams 通知：向自己发送Microsoft Teams 消息。可以自定义标题和消息内容。
  1. 对于 选择操作，请选择 Teams -->消息发送给个人 或 群聊消息，或 频道帖子。
  2. 根据所选内容执行以下步骤之一：
    - 如果选择了“ 邮件到个人 ”选项，请输入接收方 的电子邮件地址 ，或使用下拉列表选择其值为电子邮件地址的属性。满足条件后，会向指定个人发送电子邮件。
    - 如果选择了 “群组聊天消息 ”选项，请从下拉列表中选择 群组聊天 。满足条件后，会将一条消息发布到群组聊天。
    - 如果选择“ 频道发布 ”选项，请从下拉列表中选择团队和频道。满足条件后，会将一条消息发布到所选通道。
  3. 对于标题，请输入 Teams 通知的标题。
  4. 对于备注，请输入 Teams 通知的备注。
    
    注释
    
    输入主题、标题或备注时，可以通过键入 @ 或选择文本框旁边的按钮来引用数据中的属性。例如，@BikepointID。
  5. 对于 上下文，请从要包括在 Teams 通知中的下拉列表中选择值。
- 运行 Fabric 活动：若要配置警报以在满足条件时启动 Fabric 管道、Spark 作业或笔记本，请执行以下步骤：
  1. 对于“选择操作”，请选择“运行管道”、“运行 Spark 作业”、“运行笔记本”或“运行函数（预览版）”。
  2. 在要运行的 Select Fabric 项上，从列表中选择 Fabric 项（管道、笔记本、Spark 作业或函数）。
  3. 选择“添加参数”并指定 Fabric 项的参数的名称及其值。可以添加多个参数。可以通过键入 @ 或选择文本框旁边的按钮从警报数据传递参数。例如，@BikepointID。
- 自定义作：若要配置警报以在满足条件时调用自定义作，请执行以下步骤：
  1. 对于 选择操作，请选择 创建自定义操作。
  2. 如在“行动”部分中提到的，先创建规则，然后按照触发自定义操作（Power Automate 流）中的步骤完成自定义操作设置。
  3. 在创建自定义操作后，在规则的 “定义” 窗格中，从 “操作” 下拉列表中选择您创建的自定义操作。
在“保存位置”中，指定保存 Activator 警报的位置。选择一个现有工作区，并将其保存在现有激活器或新激活器中。
选择“创建”以创建 Activator 规则。

在 KQL 查询集上设置警报

打开包含 KQL 查询集的工作区。
浏览到 KQL 查询集并选择它以打开。
运行查询。 Activator 会根据后续步骤中设置的时间频率检查此查询的结果，并针对结果集中返回的每条记录发送警报。例如，如果计划的查询返回五条记录，则 Activator 会发送五条警报。
查询运行完以后，选择顶部功能区中的“设置警报”。

示例 1 - 当计数大于阈值时出现的单个结果

例如，如果过去 5 分钟内表中的记录数超过阈值，则以下查询会返回警报。查询的最后两行是关键，其中创建了与筛选器匹配的记录计数，只有当计数大于阈值时才返回结果。

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

示例 2 - 使用包含多个值的数组创建单个结果

在以下示例中，如果任何街区的自行车数量超过给定的阈值，则查询会返回警报。为了获取该数字高于阈值的所有邻域的单个警报，查询将生成以返回单个记录（这意味着，单个警报），该记录是使用 make_list（）运算符完成的。若要编辑警报以包含达到阈值的邻里列表，请参阅 “可选：在激活器中编辑规则”。

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

定义警报条件

在显示的 “添加规则 ”侧窗格中，按照以下步骤定义警报条件：

在 “详细信息 ”部分中，提供激活器警报规则的名称。
在监视部分中，设置查询运行的时间频率。默认为 5 分钟。
在 “条件” 部分中，按如下所示指定警报条件：
- 如果可视化效果没有维度，可以选择“每次在以下情况下发生事件时”条件，通过选择要监视的特定字段来监视数据流中的变化。
- 在“当 ... 时”下拉菜单中，设置要评估的值。
- 在“条件”下拉菜单中，设置要评估的条件。有关详细信息，请参阅条件。
- 在 “事件” 字段中，设置触发警报之前必须满足条件的次数。
在 “操作” 部分中，选择以下操作之一：
- 发送电子邮件通知：
  1. 对于选择操作，请选择发送电子邮件。
  2. 对于 “收件人”，请输入接收方的电子邮件地址，或使用下拉列表选择其值为电子邮件地址的属性。默认情况下，电子邮件地址将在此处填充。
  3. 对于 “主题”，请输入电子邮件通知的主题。
  4. 对于标题，请输入电子邮件通知的标题。
  5. 对于备注，请输入电子邮件通知的备注。
    
    注释
    
    输入主题、标题或备注时，可以通过键入 @ 或选择文本框旁边的按钮来引用数据中的属性。例如，@BikepointID。
  6. 对于 上下文，请从要包含在电子邮件通知中的下拉列表中选择值。
- 发送 Microsoft Teams 通知：向自己发送Microsoft Teams 消息。可以自定义标题和消息内容。
  1. 对于 选择操作，请选择 Teams -->个别消息 或 群聊消息，或 频道帖子。
  2. 根据所选内容执行以下步骤之一：
    - 如果选择了“ 邮件到个人 ”选项，请输入接收方 的电子邮件地址 ，或使用下拉列表选择其值为电子邮件地址的属性。满足条件后，会向指定个人发送电子邮件。
    - 如果选择了 “群组聊天消息 ”选项，请从下拉列表中选择 群组聊天 。满足条件后，会将一条消息发布到群组聊天。
    - 如果选择“ 频道发布 ”选项，请从下拉列表中选择团队和频道。满足条件后，会将一条消息发布到所选通道。
  3. 对于标题，请输入 Teams 通知的标题。
  4. 在备注中输入 Teams 通知的备注。
    
    注释
    
    输入主题、标题或备注时，可以通过键入 @ 或选择文本框旁边的按钮来引用数据中的属性。例如，@BikepointID。
  5. 对于 上下文，请从要包括在 Teams 通知中的下拉列表中选择值。
- 运行 Fabric 活动：若要配置警报以在满足条件时启动 Fabric 管道、Spark 作业或笔记本，请执行以下步骤：
  1. 对于“选择操作”，请选择“运行管道”、“运行 Spark 作业”、“运行笔记本”或“运行函数（预览版）”。
  2. 在要运行的 Select Fabric 项上，从列表中选择 Fabric 项（管道、笔记本、Spark 作业或函数）。
  3. 选择“添加参数”并指定 Fabric 项的参数的名称及其值。可以添加多个参数。可以通过键入 @ 或选择文本框旁边的按钮从警报数据传递参数。例如，@BikepointID。
- 自定义作：若要配置警报以在满足条件时调用自定义作，请执行以下步骤：
  1. 对于 选择操作，请选择 创建自定义操作。
  2. 如“操作部分”中所述，先创建规则，然后按照触发自定义操作 (Power Automate 流程)中的步骤完成自定义操作设置。
  3. 在创建自定义操作后，在规则的“定义”窗格中，从“操作”下拉列表中选择您创建的自定义操作。
在“保存位置”中，指定保存 Activator 警报的位置。选择一个现有工作区，并将其保存在现有激活器或新激活器中。

“添加规则”侧窗格中“保存位置”部分的屏幕截图。

选择“创建”以创建 Activator 规则。

可选：在 Activator 中编辑规则

保存激活器后，侧窗格中会显示指向项的链接。选择该链接可在 Activator 中进一步进行编辑。若要执行以下操作之一，则可使用此步骤：

将其他收件人添加到警报。
更改警报的内容，使之反映触发了警报的具体数据。
定义比“设置警报”窗格中的现有警报条件更复杂的警报条件。

有关如何在 Activator 中编辑规则的信息，请参阅创建 Activator 规则。

在激活器本身中，还可以查看查询结果的历史记录和规则激活的历史记录。有关详细信息，请参阅创建 Activator 规则。

反馈

此页面是否有帮助？

Last updated on 2025-12-08

通过

根据 KQL 查询集创建 Activator 警报

示例方案

先决条件

在 KQL 查询集上设置警报

定义警报条件

可选：在 Activator 中编辑规则

相关内容

反馈

其他资源