goetzb / rds-pgbadger

Fetch logs from RDS instance, and process them with pgBadger

RDS-Pgbadger

Fetches RDS log files and analyzes them with pgbadger.

Prerequisites

Make sure your credentials are set in the ~/.aws/credentials file. Also, you can set a region in the ~/.aws/config file, so passing region option to the script is not needed. Last but not least, make sure you have pgbadger installed and reacheable from your $PATH.

Installation

You can install it using pip:

$ pip install rdspgbadger

Usage

To build a pgbadger report, just run the following (replacing instanceid by your instance ID):

$ rds-pgbadger instanceid

Options

Only the Instance ID is mandatory, but there are also other options you can use:

• -d, --date : by default the script downloads all the available logs. By specifying a date in the format YYYY-MM-DD, you can then download only that day's logs.
• -r, --region : by default the script use the region specified in your AWS config file. If none, or if you wish to change it, you can use this option to do so.
• -o, --output : by default the script outputs log files and reports to the out folder. This option allows you to change it.
• -n, --no-process : download log file(s), but do not process them with PG Badger.

Contribute

For any request, feel free to make a pull request or fill an issue on Github.