Menu
AWS CloudFormation
User Guide (API Version 2010-05-15)

CloudWatch Logs MetricFilter MetricTransformation Property

MetricTransformation is a property of the AWS::Logs::MetricFilter resource that describes how to transform log streams into a CloudWatch metric.

Syntax

JSON

Copy
{ "MetricName": String, "MetricNamespace": String, "MetricValue": String }

YAML

Copy
MetricName: String MetricNamespace: String MetricValue: String

Properties

Note

For more information about constraints and values for each property, see MetricTransformation in the Amazon CloudWatch Logs API Reference.

MetricName

The name of the CloudWatch metric to which the log information will be published.

Required: Yes

Type: String

MetricNamespace

The destination namespace of the CloudWatch metric. Namespaces are containers for metrics. For example, you can add related metrics in the same namespace.

Required: Yes

Type: String

MetricValue

The value that is published to the CloudWatch metric. For example, if you're counting the occurrences of a particular term like Error, specify 1 for the metric value. If you're counting the number of bytes transferred, reference the value that is in the log event by using $ followed by the name of the field that you specified in the filter pattern, such as $size.

Required: Yes

Type: String

Examples

For samples of the MetricTransformation property, see AWS::Logs::MetricFilter or Amazon CloudWatch Logs Template Snippets.