Dimension
A dimension is a name/value pair that is part of the identity of a metric. Because dimensions are part of the unique
identifier for a metric, whenever you add a unique name/value pair to one of
your metrics, you are creating a new variation of that metric. For example, many Amazon EC2 metrics publish
InstanceId as a dimension name, and the actual instance ID as the value for that dimension.
You can assign up to 30 dimensions to a metric.
Contents
- Name
-
The name of the dimension. Dimension names must contain only ASCII characters, must include at least one non-whitespace character, and cannot start with a colon (
:). ASCII control characters are not supported as part of dimension names.Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Required: Yes
- Value
-
The value of the dimension. Dimension values must contain only ASCII characters and must include at least one non-whitespace character. ASCII control characters are not supported as part of dimension values.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1024.
Required: Yes
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: