Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Add optional -p option to prepend metrics before forwarding to blueflood

Project description

# Description

Graphite _'backend'_. Twisted-based server accepts graphite source metrics and forward them to [blueflood][blueflood-git].

Server accepts only pickle protocols metrics (as it's the only protocol used by graphite `carbon-relay`.)

It does very primitive _'caching'_: aggregates all metrics and flushes them in regular intervals.

The subsequent version of package is renamed to blueflood-carbon-forwarder.

# Dependencies

* twisted
* mock
* pytest
* txKeystone

# Installation

git clone
cd blueflood-carbon-forwarder
python install

# Running

twistd blueflood-forward
| Switch | Description | default |
| ----- | ------- | --------- |
| -e | Endpoint to listen on for pickle protocol metrics | tcp:2004 |
| -i | Metrics send interval, sec | 30.0 |
| -b | Blueflood address | http://localhost:19000 |
| -t | Tenant ID | tenant |
| -p | Prefix to be prepended to metrics name | metric_prefix |
| --ttl | TimeToLive value for metrics, sec | 86400 |
| -u | Keystone user | |
| -k | Keystone key | |
| --auth-url | Keystone token URL | |

In case you need no authentication leave `-u`/`--user` command line argument empty (default value).

# Sending metrics

To send a test metric to the twistd server you started above, you can run the following:
python tests/scripts/
Modify the script accordingly for your local testing

# Configuration

Configuration is done with command line arguments passed to twistd daemon when running:
twistd -n -l - blueflood-forward --help



Logging can be controlled using LogObserver provided along or you can use your own LogObserver

twistd --logger carbonforwarderlogging.forwarder_log_observer.get_log_observer blueflood-forward

[blueflood-git]: "blueflood"

# Running unit tests

Project details

Download files

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

Files for graphite-blueflood, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size graphite-blueflood-0.2.1.tar.gz (39.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page