A command line tool that retrieves AWS RDS Enhanced Monitoring statistics from CloudWatch and displays the information in a format similar to the Linux top command.

Status: Alpha

• Retrieves and displays RDS instance system, network, disk IO, and process statistics.
• Supports sorting by memory usage or CPU usage.

• Go programming language installed (version 1.19 or higher)
• AWS CLI configured with the appropriate credentials and region
• RDS Enhanced Monitoring enabled for your RDS instances

RDS Enhanced Monitoring displays a maximum of 100 processes and threads, which are a combination of the top CPU consuming and memory consuming processes and threads. If there are more than 50 processes and more than 50 threads, the console displays the top 50 consumers in each category. For more information, refer to the official AWS documentation.

git clone https://github.com/sherwind/aws-rds-top.git
cd aws-rds-top
go build -o rds-top

./rds-top [options] <rds-instance-name>
./rds-top --start-time=$(date -v-13d +%s) <rds-instance-name>
./rds-top --sort-by-mem --start-time=$(date -j -f "%Y-%m-%dT%H:%M:%S%z" "2019-09-12T13:05:00+0000" +%s) <rds-instance-name> | grep -v 'idle$'

--start-time=t           Optional: Specify the start time in seconds since the Unix epoch
--sort-by-mem            Optional: Sorts output by memory. Default is to sort by CPU

This project is licensed under the MIT License.

Please feel free to submit issues, fork the repository, and send pull requests.