AWS SDK Version 3 for .NET
API Reference

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.

Encapsulates the statistical data that CloudWatch computes from metric data.

Inheritance Hierarchy

System.Object
  Amazon.CloudWatch.Model.Datapoint

Namespace: Amazon.CloudWatch.Model
Assembly: AWSSDK.CloudWatch.dll
Version: 3.x.y.z

Syntax

C#
public class Datapoint

The Datapoint type exposes the following members

Constructors

NameDescription
Public Method Datapoint()

Properties

NameTypeDescription
Public Property Average System.Double

Gets and sets the property Average.

The average of the metric values that correspond to the data point.

Public Property ExtendedStatistics System.Collections.Generic.Dictionary<System.String, System.Double>

Gets and sets the property ExtendedStatistics.

The percentile statistic for the data point.

Public Property Maximum System.Double

Gets and sets the property Maximum.

The maximum metric value for the data point.

Public Property Minimum System.Double

Gets and sets the property Minimum.

The minimum metric value for the data point.

Public Property SampleCount System.Double

Gets and sets the property SampleCount.

The number of metric values that contributed to the aggregate value of this data point.

Public Property Sum System.Double

Gets and sets the property Sum.

The sum of the metric values for the data point.

Public Property Timestamp System.DateTime

Gets and sets the property Timestamp.

The time stamp used for the data point.

Public Property Unit Amazon.CloudWatch.StandardUnit

Gets and sets the property Unit.

The standard unit for the data point.

Examples

This example shows how to get statistics for a metric.

Get metric statistics example

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 = client.GetMetricStatistics(request);

if (response.Datapoints.Count > 0)
{
  foreach (var point in response.Datapoints)
  {
    Console.WriteLine(point.Timestamp.ToShortDateString() +
      " " + point.Minimum + "%");
  }
}
      

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5, 4.0, 3.5