概述
日志警报是 Azure 警报中支持的警报类型之一。 使用日志警报,用户可以通过 Log Analytics 查询按每个设置的频率评估资源日志并基于结果触发警报。 规则可以使用操作组触发一个或多个操作。
Note: 可以将 Log Analytics 工作区中的日志数据发送到 Azure Monitor 指标存储。 指标警报具有不同的行为,该行为可能更可取,具体取决于你要使用的数据。 要了解如何将日志路由到指标,请参阅日志的指标警报。
Note: 当前不对 API 版本
2020-05-01-preview和以资源为中心的日志警报收取额外费用。 未来将公布预览版中的功能的定价以及开始计费之前提供的通知。 如果你选择在通知期过后继续使用新 API 版本和以资源为中心的日志警报,需要按适用的费率付费。
先决条件
日志警报运行对 Log Analytics 数据的查询。 首先,你应开始收集日志数据,并查询日志数据以查找问题。 可以使用 Log Analytics 中的警报查询示例主题来了解可发现的内容或开始编写你自己的查询。
Azure 监视参与者是创建、修改和更新日志警报所需的常见角色。 还需要具有对资源日志的访问和查询执行权限。 对资源日志具有部分访问权限可能会导致查询失败或返回部分结果。 详细了解如何在 Azure 中配置日志警报。
Note: 过去使用旧版 Log Analytics 警报 API 管理 Log Analytics 的日志警报。 详细了解如何切换到当前的 SCHEDULEDQUERYRULES API。
查询评估定义
日志搜索规则条件定义开始于:
- 要运行什么查询?
- 如何使用结果?
以下各节介绍了可用于设置上述逻辑的不同参数。
日志查询
用来评估规则的 Log Analytics 查询。 此查询返回的结果用来确定是否将触发某个警报。 查询的范围可以是:
- 特定资源,例如虚拟机。
- 大规模资源,例如订阅或资源组。
- 使用跨资源查询的多个资源。
Important: 警报查询具有约束,可确保结果的最佳性能和相关性。 在此处了解更多信息。
Important: 使用当前 scheduledQueryRules API 仅支持以资源为中心的查询和跨资源查询。 如果使用旧版 Log Analytics 警报 API,则需要切换。 了解有关切换的详细信息
查询时间范围
时间范围是在规则条件定义中设置的。 在工作区和 Application Insights 中,它被称为“期间”。 在所有其他资源类型中,它被称为“替代查询时间范围”。
与在日志分析中一样,时间范围将查询数据限制在指定的范围内。 即使在查询中使用了 ago 命令,时间范围也将适用。
例如,即使文本包含 ago(1d),查询也会扫描 60 分钟(当时间范围为 60 分钟时)。 时间范围和查询时间筛选需要匹配。 在这个例子中,将“期间” / “替代查询时间范围”更改为一天就可以正常工作 。
测量
日志警报将日志转换为可计算的数字值。 你可以度量两个不同的事项:
结果表行的计数
结果计数是默认度量值。 适用于处理 Windows 事件日志、Syslog 和应用程序异常等事件。 当评估的时间窗口中发生或未发生日志记录时触发。
当你尝试检测日志中的数据时,日志警报效果最佳。 当你试图检测日志中是否缺少数据时,它的效果就不太好。 例如,对虚拟机检测信号发出警报。
对于工作区和 Application Insights,它在选择“结果数”的情况下称为“基于”。 在所有其他资源类型中,它在选择“表行”的情况下称为“度量值”。
Note: 由于日志是半结构化数据,它们本质上比指标更隐蔽,因此,尝试检测日志中是否缺少数据时可能会遇到误触发,你应考虑使用指标警报。 你可以使用日志的指标警报将数据从日志发送到指标存储。
结果表行计数用例示例
你希望知道你的应用程序何时以错误代码 500(内部服务器错误)做出响应。 可以创建一个警报规则,详情如下:
- 查询:
requests
| where resultCode == "500"
- 时间范围/聚合粒度: 15 分钟
- 警报频率: 15 分钟
- 阈值: 大于 0
然后,警报规则监视所有以错误代码 500 结束的请求。 在过去的 15 分钟,该查询每 15 分钟运行一次。 即使找到一条记录,它也会引发警报并触发所配置的操作。
基于数值列计算度量值(例如 CPU 计数器值)
对于工作区和 Application Insights,它在选择“指标度量”的情况下称为“基于”。 在所有其他资源类型中,它在选择任何数字列名称的情况下称为“度量值”。
聚合类型
对多条记录执行的用于将其聚合为一个数值的计算。 例如:
- 计数 返回查询中的记录数
- 平均值 返回所定义的度量值列 聚合粒度的平均值。
在工作区和 Application Insights 中,它仅在“指标度量”度量值类型中受支持。 查询结果必须包含一个名为 AggregatedValue 的列,该列在用户定义的聚合之后提供数值。 在所有其他资源类型中,“聚合类型”是从该名称的字段中选择的。
聚合粒度
确定用于将多条记录聚合为一个数值的间隔。 例如,如果你指定了 5 分钟,则记录会使用指定的 聚合类型 按 5 分钟间隔进行分组。
在工作区和 Application Insights 中,它仅在“指标度量”度量值类型中受支持。 查询结果必须包含在查询结果中设置间隔的 bin()。 在所有其他资源类型中,控制此设置的字段称为“聚合粒度”。
Note: 由于 bin() 可能导致不均匀的时间间隔,因此,警报服务会自动将 bin() 函数转换为针对运行时的相应时间的 bin_at() 函数,以确保生成针对确定时间点的结果。
按警报维度拆分
通过将警报分组为唯一的组合,按数字或字符串列将警报拆分为单独的警报。 当大规模(在订阅或资源组范围内)创建以资源为中心的警报时,可以按 Azure 资源 ID 列进行拆分。 按 Azure 资源 ID 列进行拆分会将警报的目标更改为指定的资源。
如果想要在多个 Azure 资源上监视相同的条件,建议按 Azure 资源 ID 列进行拆分。 例如,监视所有虚拟机的 CPU 使用率超过 80%。 如果希望对范围中的多个资源设置条件,例如监视资源组范围中至少有 5 台计算机的 CPU 使用率超过 80%,也可决定不拆分。
在工作区和 Application Insights 中,它仅在“指标度量”度量值类型中受支持。 此字段称为“聚合依据”。 它限制为三个列。 查询中的分组依据列超过三个可能会导致意外的结果。 在所有其他资源类型中,它是在条件的“拆分依据维度”部分中配置的(限制为六个拆分)。
按警报维度拆分的示例
例如,你想要监视在特定资源组中运行你的网站/应用的多个虚拟机的错误。 可以如下所述使用日志警报规则实现此目的:
-
查询:
// Reported errors union Event, Syslog // Event table stores Windows event records, Syslog stores Linux records | where EventLevelName == "Error" // EventLevelName is used in the Event (Windows) records or SeverityLevel== "err" // SeverityLevel is used in Syslog (Linux) records将工作区和 Application Insights 与 指标度量 警报逻辑一起使用时,需要将以下行添加到查询文本:
| summarize AggregatedValue = count() by Computer, bin(TimeGenerated, 15m) -
资源 ID 列: _ResourceId(目前,按警报规则中的资源 ID 列拆分这一做法仅适用于订阅和资源组)
-
维度/聚合依据:
- Computer = VM1、VM2(在警报规则定义中筛选值这一做法目前不适用于工作区和 Application Insights。 请在查询文本中筛选。)
-
时间范围/聚合粒度: 15 分钟
-
警报频率: 15 分钟
-
阈值: 大于 0
此规则监视在过去 15 分钟内是否有任何虚拟机出现错误事件。 每个虚拟机都会被单独监视,并且会分别触发操作。
Note: 按警报维度拆分这一做法仅适用于当前的 scheduledQueryRules API。 如果使用旧版 Log Analytics 警报 API,则需要切换。 了解有关切换的详细信息。 仅在 API
2020-05-01-preview及更高版本中支持大规模的以资源为中心的警报。
警报逻辑定义
定义要运行的查询并对结果进行评估后,你需要定义警报逻辑以及何时触发操作。 以下各节介绍了你可以使用的各个参数:
阈值和运算符
查询结果将转换为一个数字,该数字将依据阈值和运算符进行比较。
频率
运行查询的间隔。 可以设置为 5 分钟到 1 天。 必须等于或小于查询时间范围才不会错过日志记录。
例如,如果你将时间段设置为 30 分钟,将频率设置为 1 小时 1 次。 如果查询在 00:00 运行,则会返回 23:30 到 00:00 之间的记录。 下次运行查询的时间将是 01:00,将返回 00:30 到 01:00 之间的记录。 从不会评估在 00:00 到 00:30 之间创建的任何记录。
触发警报的违规次数
你可以指定警报评估时段和触发警报所需的故障次数。 允许你更好地定义触发警报的影响时间。
例如,如果你的 聚合粒度规则定义为“5 分钟”,则只有在过去一小时内发生三次故障(15 分钟)时,你才能触发警报。 此设置由你的应用程序业务策略定义。
状态和解决警报
日志警报是无状态的。 每次满足条件时,都会触发警报,即使之前已触发过。 触发的警报不会解决。 你可以将警报标记为关闭。 你还可以对操作进行“静音”,以防它们在警报规则触发后的一段时间内触发。
在工作区和 Application Insights 中,它称为“抑制警报”。 在所有其他资源类型中,它称为“将操作‘静音’”。
请参阅此警报评估示例:
| 时间 | 日志条件评估 | 结果 | ------- | ----------| ----------| ------- | 00:05 | FALSE | 警报不会触发。 没有调用任何操作。 | 00:10 | TRUE | 警报触发,操作组被调用。 新警报处于活动状态。 | 00:15 | TRUE | 警报触发,操作组被调用。 新警报处于活动状态。 | 00:20 | FALSE | 警报不会触发。 没有调用任何操作。 以前的警报保持活动状态。
日志警报的定价和计费
定价信息位于 Azure Monitor 定价页中。 日志警报在资源提供程序 microsoft.insights/scheduledqueryrules 下列出,同时列出的有:
- Application Insights 上的日志警报,显示时带有确切的资源名称以及资源组和警报属性。
- 如果是使用 scheduledQueryRules API 创建的,则 Log Analytics 上的日志警报显示时带有确切的资源名称以及资源组和警报属性。
- 通过旧式 Log Analytics API 创建的日志警报不是被跟踪的 Azure资源,没有强制使用的唯一资源名称。 这些警报仍作为隐藏资源在
microsoft.insights/scheduledqueryrules上创建,这些资源的资源命名结构为<WorkspaceName>|<savedSearchId>|<scheduleId>|<ActionId>。 针对旧式 API 的日志警报显示时带有上述隐藏的资源名称以及资源组和警报属性。
Note: 在隐藏的资源名称中,不受支持的资源字符(例如
<, >, %, &, \, ?, /)将被替换为_,这也会在计费信息中反映出来。
Note: 过去使用旧式 Log Analytics 警报 API 以及 Log Analytics 保存的搜索和警报的旧式模板管理 Log Analytics 的日志警报。 详细了解如何切换到当前的 SCHEDULEDQUERYRULES API。 任何警报规则管理都应该使用旧式 Log Analytics API 执行,直到你决定切换并且在这种情况下无法使用隐藏的资源。
后续步骤
- 了解如何在 Azure 中创建日志警报。
- 了解 Azure 日志警报中的 Webhook。
- 了解 Azure 警报。
- 详细了解 Log Analytics。
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 yanivlavi)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
