AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS::Logs::MetricFilter

AWS::Logs::MetricFilter 资源创建一个指标筛选条件,该筛选条件描述 Amazon CloudWatch Logs 如何从您指定的日志中提取信息并将其转换成 Amazon CloudWatch 指标。如果一个日志组有多个关联的指标筛选条件,则这些筛选条件全都会应用于该组中的日志流。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

Copy
{ "Type": "AWS::Logs::MetricFilter",     "Properties": { "FilterPattern": String, "LogGroupName": String, "MetricTransformations": [ MetricTransformations, ... ] } }

YAML

Copy
Type: "AWS::Logs::MetricFilter" Properties: FilterPattern: String LogGroupName: String MetricTransformations: MetricTransformations

属性

注意

有关每个属性的限制条件和值的更多信息,请参阅 Amazon CloudWatch Logs API Reference 中的 PutMetricFilter

FilterPattern

描述 CloudWatch Logs 解释日志中的每个条目所采用的模式。日志条目可能包含时间戳、IP 地址、错误代码、传输的字节数等字段。您可以使用该模式来指定这些字段,并指定要在日志文件中查找什么内容。例如,如果您想查找以 1234 开头的错误代码,则可以使用筛选条件模式 [timestamps, ip_addresses, error_codes = 1234*, size, ...]。有关更多信息,请参阅 Amazon CloudWatch 用户指南 中的筛选条件和模式语法

Required: Yes

Type: String

更新要求无需中断

LogGroupName

您想与此指标筛选条件关联的现有日志组的名称。

Required: Yes

Type: String

更新要求替换

MetricTransformations

描述如何将日志中的数据转换成 CloudWatch 指标。

Required: Yes

类型CloudWatch Logs MetricFilter MetricTransformation 属性 的列表。

重要

目前只能为每个指标筛选条件指定一个指标转换。如果您想指定多个指标转换,则必须指定多个指标筛选条件。

更新要求无需中断

示例

以下示例在每当状态代码字段包含 404Count 值时将值 1 发送到 404 指标。

JSON

Copy
"404MetricFilter": { "Type": "AWS::Logs::MetricFilter", "Properties": { "LogGroupName": { "Ref": "myLogGroup" }, "FilterPattern": "[ip, identity, user_id, timestamp, request, status_code = 404, size]", "MetricTransformations": [ { "MetricValue": "1", "MetricNamespace": "WebServer/404s", "MetricName": "404Count" } ] } }

YAML

Copy
404MetricFilter: Type: "AWS::Logs::MetricFilter" Properties: LogGroupName: Ref: "myLogGroup" FilterPattern: "[ip, identity, user_id, timestamp, request, status_code = 404, size]" MetricTransformations: - MetricValue: "1" MetricNamespace: "WebServer/404s" MetricName: "404Count"

附加信息

有关其他示例模板,请参阅 Amazon CloudWatch Logs 模板代码段

本页内容: