使用筛选条件从日志事件创建指标 - Amazon CloudWatch Logs
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

使用筛选条件从日志事件创建指标

您可以通过创建一个或多个指标筛选条件来搜索和筛选进入 CloudWatch Logs 的日志数据。指标筛选条件定义在日志数据发送到 CloudWatch Logs 时要在日志数据中查找的字词和模式。CloudWatch Logs 使用这些指标筛选条件将日志数据转换为 CloudWatch 数值指标,供您生成图表或设置警报。

在通过日志筛选条件创建指标时,还可以选择为该指标分配维度和单位。如果指定单位,请确保在您创建筛选条件时指定正确的单位。稍后更改筛选条件的单位将无效。

在查看这些指标或设置警报时,您可以使用任何类型的 CloudWatch 统计数据,包括百分位数统计数据。

注意

仅当没有任何指标的值为负值时,才支持适用于指标的百分位数统计数据。如果您将指标筛选器设置为可以报告负数,则当它的值有负数时,该指标的百分位数统计数据不可用。有关更多信息,请参阅百分位数

筛选条件不会以回溯方式筛选数据。筛选条件只会发布在创建后发生的事件的指标数据点。筛选结果返回前 50 行,如果筛选结果上的时间戳早于指标创建时间,则不会显示这些行。

概念

每个指标筛选条件都由以下关键元素组成:

默认值

在提取日志但未找到匹配日志的时间段中报告给指标筛选条件的值。通过将此项设置为 0,您可以确保在每个这样的时间段中都报告了数据,防止出现存在无匹配数据时间段的“断点”指标。如果在 1 分钟时间段内未提取日志,则不会报告任何值。

如果将维度分配给由指标筛选条件创建的指标,则无法为该指标分配默认值。

维度

维度是进一步定义指标的键值对。您可以将维度分配给通过指标筛选条件创建的指标。由于维度是指标的唯一标识符的一部分,因此每当从日志中提取唯一的名称/值对时,都会创建该指标的一个新变体。

筛选条件模式

一种符号描述,说明 CloudWatch Logs 应如何解释每个日志事件中的数据。例如,日志条目可能包含时间戳、IP 地址、字符串等。您可以使用模式来指定要在日志文件中查找的内容。

指标名称

CloudWatch 指标的名称,受监控的日志信息应该发布到此指标。例如,您可以向名为 ErrorCount 的指标发布信息。

指标命名空间

新 CloudWatch 指标的目标命名空间。

指标值

每次发现匹配日志时发布到指标的数字值。例如,如果您要对特定字词 (如“Error”) 的出现次数进行计数,则每出现一次,该值都将增加“1”。如果要计算传输的字节数,您可以按照在日志事件中找到的实际字节数累加。