CloudWatch code examples for the SDK for .NET

Overview

Shows how to use the AWS SDK for .NET to work with Amazon CloudWatch.

CloudWatch provides a reliable, scalable, and flexible monitoring solution that you can start using within minutes.

⚠ Important

• Running this code might result in charges to your AWS account. For more details, see AWS Pricing and Free Tier.
• Running the tests might result in charges to your AWS account.
• We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see Grant least privilege.
• This code is not tested in every AWS Region. For more information, see AWS Regional Services.

Code examples

Prerequisites

For prerequisites, see the README in the dotnetv3 folder.

To enable billing metrics and statistics for these examples, make sure to enable billing alerts for your account.

Basics

Code examples that show you how to perform the essential operations within a service.

• Learn the basics

Single actions

Code excerpts that show you how to call individual service functions.

• DeleteAlarms
• DeleteAnomalyDetector
• DeleteDashboards
• DescribeAlarmHistory
• DescribeAlarms
• DescribeAlarmsForMetric
• DescribeAnomalyDetectors
• DisableAlarmActions
• EnableAlarmActions
• GetDashboard
• GetMetricData
• GetMetricStatistics
• GetMetricWidgetImage
• ListDashboards
• ListMetrics
• PutAnomalyDetector
• PutDashboard
• PutMetricAlarm
• PutMetricData

Run the examples

Instructions

For general instructions to run the examples, see the README in the dotnetv3 folder.

Some projects might include a settings.json file. Before compiling the project, you can change these values to match your own account and resources. Alternatively, add a settings.local.json file with your local settings, which will be loaded automatically when the application runs.

After the example compiles, you can run it from the command line. To do so, navigate to the folder that contains the .csproj file and run the following command:

dotnet run

Alternatively, you can run the example from within your IDE.

Learn the basics

This example shows you how to do the following:

• List CloudWatch namespaces and metrics.
• Get statistics for a metric and for estimated billing.
• Create and update a dashboard.
• Create and add data to a metric.
• Create and trigger an alarm, then view alarm history.
• Add an anomaly detector.
• Get a metric image, then clean up resources.

Tests

⚠ Running tests might result in charges to your AWS account.

To find instructions for running these tests, see the README in the dotnetv3 folder.

Additional resources

• CloudWatch User Guide
• CloudWatch API Reference
• SDK for .NET CloudWatch reference

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

SPDX-License-Identifier: Apache-2.0