Amazon Relational Database Service
User Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Performance Insights Metrics Published to Amazon CloudWatch

Performance Insights automatically publishes metrics to Amazon CloudWatch. The same data can be queried from Performance Insights, but having the metrics in CloudWatch makes it easy to add CloudWatch alarms. It also makes it easy to add the metrics to existing CloudWatch Dashboards.

Metric Description

DBLoad

The number of active sessions for the DB engine. Typically, you want the data for the average number of active sessions. In Performance Insights, this data is queried as db.load.avg.

DBLoadCPU

The number of active sessions where the wait event type is CPU. In Performance Insights, this data is queried as db.load.avg, filtered by the wait event type CPU.

DBLoadNonCPU

The number of active sessions where the wait event type is not CPU.

You can examine these metrics using the CloudWatch console, the AWS CLI, or the CloudWatch API.

For example, you can get the statistics for the DBLoad metric by running the get-metric-statistics command.

aws cloudwatch get-metric-statistics --region us-west-2 --namespace AWS/RDS --metric-name DBLoad --period 60 --statistics Average --start-time 1532035185 --end-time 1532036185 --dimensions Name=DBInstanceIdentifier,Value=db-loadtest-0

This example generates output similar to the following.

{ "Datapoints": [ { "Timestamp": "2018-07-19T21:30:00Z", "Unit": "None", "Average": 2.1 }, { "Timestamp": "2018-07-19T21:34:00Z", "Unit": "None", "Average": 1.7 }, { "Timestamp": "2018-07-19T21:35:00Z", "Unit": "None", "Average": 2.8 }, { "Timestamp": "2018-07-19T21:31:00Z", "Unit": "None", "Average": 1.5 }, { "Timestamp": "2018-07-19T21:32:00Z", "Unit": "None", "Average": 1.8 }, { "Timestamp": "2018-07-19T21:29:00Z", "Unit": "None", "Average": 3.0 }, { "Timestamp": "2018-07-19T21:33:00Z", "Unit": "None", "Average": 2.4 } ], "Label": "DBLoad" }

For more information about CloudWatch, see What is Amazon CloudWatch? in the Amazon CloudWatch User Guide.