AWS SDK Version 4 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.Nullable<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.

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Public Property Maximum System.Nullable<System.Double>

Gets and sets the property Maximum.

The maximum metric value for the data point.

Public Property Minimum System.Nullable<System.Double>

Gets and sets the property Minimum.

The minimum metric value for the data point.

Public Property SampleCount System.Nullable<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.Nullable<System.Double>

Gets and sets the property Sum.

The sum of the metric values for the data point.

Public Property Timestamp System.Nullable<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 = await client.GetMetricStatisticsAsync(request);

if (response.Datapoints != null)
{
    foreach (var point in response.Datapoints)
    {
        Console.WriteLine(point.Timestamp.Value.ToShortDateString() +
          " " + point.Minimum + "%");
    }
}
            

Version Information

.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