Specifies the CloudWatch metric dimensions to publish with this metric.
Because dimensions are part of the unique identifier for a metric, whenever a unique dimension name/value pair is extracted from your logs, you are creating a new variation of that metric.
For more information about publishing dimensions with metrics created by metric filters, see Publishing dimensions with metrics from values in JSON or space-delimited log events.
Important
Metrics extracted from log events are charged as custom metrics.
To prevent unexpected high charges, do not specify high-cardinality fields such as
IPAddress or requestID as dimensions. Each different value
found for
a dimension is treated as a separate metric and accrues charges as a separate custom metric.
To help prevent accidental high charges, Amazon disables a metric filter if it generates 1000 different name/value pairs for the dimensions that you have specified within a certain amount of time.
You can also set up a billing alarm to alert you if your charges are higher than expected. For more information, see Creating a Billing Alarm to Monitor Your Estimated AWS Charges.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
Properties
Key-
The name for the CloudWatch metric dimension that the metric filter creates.
Dimension names must contain only ASCII characters, must include at least one non-whitespace character, and cannot start with a colon (:).
Required: Yes
Type: String
Minimum:
1Maximum:
255Update requires: No interruption
Value-
The log event field that will contain the value for this dimension. This dimension will only be published for a metric if the value is found in the log event. For example,
$.eventTypefor JSON log events, or$serverfor space-delimited log events.Required: Yes
Type: String
Minimum:
1Maximum:
255Update requires: No interruption
