Viewing DB instance metrics in the CloudWatch console and Amazon CLI - Amazon Relational Database Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Viewing DB instance metrics in the CloudWatch console and Amazon CLI

Following, you can find details about how to view metrics for your DB instance using CloudWatch. For information on monitoring metrics for your DB instance's operating system in real time using CloudWatch Logs, see Monitoring OS metrics with Enhanced Monitoring.

When you use Amazon RDS resources, Amazon RDS sends metrics and dimensions to Amazon CloudWatch every minute. You can use the following procedures to view the metrics for Amazon RDS in the CloudWatch console and CLI.

To view metrics using the Amazon CloudWatch console

Metrics are grouped first by the service namespace, and then by the various dimension combinations within each namespace.

  1. Open the CloudWatch console at https://console.amazonaws.cn/cloudwatch/.

    The CloudWatch overview home page appears.

    CloudWatch overview page

  2. If necessary, change the Amazon Web Services Region. From the navigation bar, choose the Amazon Web Services Region where your Amazon resources are. For more information, see Regions and endpoints.

  3. In the navigation pane, choose Metrics and then All metrics.

    Choose metric namespace

  4. Scroll down and choose the RDS metric namespace.

    The page displays the Amazon RDS dimensions. For descriptions of these dimensions, see Amazon CloudWatch dimensions for Amazon RDS.

    Choose metric namespace

  5. Choose a metric dimension, for example By Database Class.

    Filter metrics

  6. Do any of the following actions:

    • To sort the metrics, use the column heading.

    • To graph a metric, select the check box next to the metric.

    • To filter by resource, choose the resource ID, and then choose Add to search.

    • To filter by metric, choose the metric name, and then choose Add to search.

    The following example filters on the db.t3.medium class and graphs the CPUUtilization metric.

    Filter metrics

To obtain metric information by using the Amazon CLI, use the CloudWatch command list-metrics. In the following example, you list all metrics in the AWS/RDS namespace.

aws cloudwatch list-metrics --namespace AWS/RDS

To obtain metric statistics, use the command get-metric-statistics. The following command gets CPUUtilization statistics for instance my-instance over the specific 24-hour period, with a 5-minute granularity.

For Linux, macOS, or Unix:

aws cloudwatch get-metric-statistics --namespace AWS/RDS \
     --metric-name CPUUtilization \
     --start-time 2021-12-15T00:00:00Z \
     --end-time 2021-12-16T00:00:00Z \
     --period 360 \
     --statistics Minimum \
     --dimensions Name=DBInstanceIdentifier,Value=my-instance

For Windows:

aws cloudwatch get-metric-statistics --namespace AWS/RDS ^
     --metric-name CPUUtilization ^
     --start-time 2021-12-15T00:00:00Z ^
     --end-time 2021-12-16T00:00:00Z ^
     --period 360 ^
     --statistics Minimum ^
     --dimensions Name=DBInstanceIdentifier,Value=my-instance

Sample output appears as follows:

{
    "Datapoints": [
        {
            "Timestamp": "2021-12-15T18:00:00Z", 
            "Minimum": 8.7, 
            "Unit": "Percent"
        }, 
        {
            "Timestamp": "2021-12-15T23:54:00Z", 
            "Minimum": 8.12486458559024, 
            "Unit": "Percent"
        }, 
        {
            "Timestamp": "2021-12-15T17:24:00Z", 
            "Minimum": 8.841666666666667, 
            "Unit": "Percent"
        }, ...
        {
            "Timestamp": "2021-12-15T22:48:00Z", 
            "Minimum": 8.366248354248954, 
            "Unit": "Percent"
        }
    ], 
    "Label": "CPUUtilization"
}

For more information, see Getting statistics for a metric in the Amazon CloudWatch User Guide.