Helper for pushing AWS CloudWatch metrics to Graphite
Project description
Cloudwatch-to-Graphite (leadbutt) is a small utility to take metrics from CloudWatch to Graphite.
Installation
Install using pip:
pip install cloudwatch-to-graphite
Usage
Cloudwatch-to-Graphite uses boto, so make sure to follow its configuration instructions. The easiest way to do this is to set up the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables.
Set up a config.yaml. You can copy the included config.yaml.example. If your graphite server is at graphite.local, you can send metrics like:
leadbutt | nc -q0 graphite.local 2003
If you have several configs you want to switch between, you can specify a custom configuration file and send extra data with:
leadbutt --config-file=production.yaml -n 20 | nc -q0 graphite.local 2003
You can even generate configs on the fly and send it in like:
generate_config_from_inventory | leadbutt --config-file=- | nc -q0 graphite.local 2003
config.yaml
What metrics to pull is in a YAML configuration file. See the example config.yaml.example for an idea of what you can do.
Developing
Install requirements:
pip install -r requirements.txt
Running test suite:
make test
Verifying tests run over all supported Python versions:
tox
Prior Art
Cloudwatch-to-Graphite was inspired by edasque’s cloudwatch2graphite. I was looking to expand it, but I wanted to use boto.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cloudwatch-to-graphite-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4671350052bed81e3a5a2e04bbf2f44dd7064eac45db1c13d001d8c6a0e6a115 |
|
MD5 | ad892cc21eea7a21e80100200d9e1e27 |
|
BLAKE2b-256 | ca9eec030f89c96668c14d8c07aa8cae0f187183b3d60b551de6ab3d7bf624d8 |
Hashes for cloudwatch_to_graphite-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0d15c86040e664fcbee89d481eaf0c9c1aebda5ce5748120bef9b24dbc87f427 |
|
MD5 | 4fb5d25b9e2ccbc2c58d9694ba8b6e0f |
|
BLAKE2b-256 | e3a05ea3cf950f6b02d0789c8a16733afed1037c0c95edb589094a8886fc546d |