rdsmon-go

rdsmon

commandline tool for monitoring aws RDS instances

Quick Start

The requirements for using rdsmon are relatively straight forward, however you will need:

Installation

Install the tool - go get -u github.com/symonk/rdsmon-go (to install the latest version)

Authentication

Typically you require an access token for a user that is configured for rds accessibility using aws IAM roles. Once your user has been created, you will require an access key and this should be either configured on disk, or exposed to the environment running rdsmon. It is completely unadvised to user the root user and the account running the tool should have as minimal permissions as possible. The IAM capabilities required by the tool are:

• Todo

Important: Properly configured IAM roles/users should be in place, tokens should be kept secure, under no circumstances should you share them with anybody. rdsmon-go utilises the same mechanisms by the aws SDK for credential detection and usage.

To better understand IAM user and policies, please refer to:

AWS IAM user creation

AWS Access Tokens

Once you have appropriate IAM roles and have created an access_key, these should be stored in:

~/.aws/credentials

[default]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_KEY

You may also want to add a default region to the aws configuration file, this should be set in:

~/.aws/config

[default]
region=us-east-1

Monitoring an RDS instance

Todo