AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
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.
Namespace: Amazon.CloudWatch.Model
Assembly: AWSSDK.CloudWatch.dll
Version: 3.x.y.z
public class Dimension
The Dimension type exposes the following members
| Name | Description | |
|---|---|---|
|
Dimension() |
| Name | Type | Description | |
|---|---|---|---|
|
Name | System.String |
Gets and sets the property 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 ( |
|
Value | System.String |
Gets and sets the property 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. |
This example shows how to get statistics for a metric.
var client = new AmazonCloudWatchClient();
var request = new GetMetricStatisticsRequest
{
Dimensions = new List<Dimension>() { dimension },
EndTime = DateTime.Today,
MetricName = "CPUUtilization",
Namespace = "AWS/EC2",
// Get statistics by day.
Period = (int)TimeSpan.FromDays(1).TotalSeconds,
// Get statistics for the past month.
StartTime = DateTime.Today.Subtract(TimeSpan.FromDays(30)),
Statistics = new List<string>() { "Minimum" },
Unit = StandardUnit.Percent
};
var response = await client.GetMetricStatisticsAsync(request);
if (response.Datapoints != null)
{
foreach (var point in response.Datapoints)
{
Console.WriteLine(point.Timestamp.Value.ToShortDateString() +
" " + point.Minimum + "%");
}
}
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.7.2 and newer