Carbon Forwarder enables you to integrate with the carbon daemons that make up the storage back end of a Graphite installation.
The integration is through a Carbon Forwarder instance that accepts pickle protocols metrics, which is the only protocol used by a graphite carbon relay.
Carbon Forwarder has the following dependencies.
Use the following command to install Carbon Forwarder.
git clone https://github.com/rackerlabs/blueflood-carbon-forwarder.git cd blueflood-carbon-forwarder python setup.py install
Use the following command to run Carbon Forwarder.
|-e||Endpoint to listen on for pickle protocol metrics||tcp:2004|
|-i||Metrics send interval, in seconds||30.0|
|-p||Prefix to add to metrics name||metric_prefix|
|--ttl||Time-to-live value for metrics, in seconds||86400|
|--auth-url||Keystone token URL|
If you don't need authentication, leave the -u/--user command line argument empty (which is the default value).
To send a test metric to the twisted server that you just started, run the following command.
Modify the script accordingly for your local testing.
To complete the configuration, pass the following command-line arguments to the twistd daemon.
twistd -n -l - blueflood-forward --help
If not using your own LogObserver, use the following command to control logging by using LogObserver.
twistd --logger carbonforwarderlogging.forwarder_log_observer.get_log_observer blueflood-forward
- For details about carbon daemons, see https://graphite.readthedocs.org/en/1.0/carbon-daemons.html
- For details about the Carbon Forwarder project, see https://github.com/rackerlabs/blueflood-carbon-forwarder
Updated 4 months ago