Skip to main content

A utility to download AWS RDS logs

Project description

A small utility to download/stream logs from Amazon AWS RDS to a local directory. When started, all log files will be downloaded, and the latest file will be watched for changes.

Installation

Make sure you already have installed

Install from PyPI:

pip install rds-log

Usage

rds-log-stream will find AWS credentials in ~/.aws/credentials or environment variables. rds-log-stream uses boto3 and finds credentials/config in the same locations.

Set up ~/.aws/credentials with AWS authentication details:

[default]
aws_access_key_id = <your access key id>
aws_secret_access_key = <your secret key>

Set up ~/.aws/config to point to your region:

[default]
region = eu-central-1

An alternative is to set up environment variables:

export AWS_ACCESS_KEY_ID="<your access key id>"
export AWS_SECRET_ACCESS_KEY="<your secret key>"
export AWS_DEFAULT_REGION="<your aws region>"

Run rds-log-stream with your database identifier and directory to store logs:

rds-log-stream yourdbinstance /your/log/destination

/your/log/destination will be populated with all current RDS logs and continously updated with new messages as they arrive.

Development

Creating a new release:

git tag x.x.x
python setup.py sdist bdist_wheel
twine upload dist/*x.x.x*

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rds-log-1.0.6.tar.gz (5.3 kB view hashes)

Uploaded Source

Built Distribution

rds_log-1.0.6-py3-none-any.whl (6.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page