Integrate Carbon Daemons with Rackspace Metrics

Description

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.

Dependencies

Carbon Forwarder has the following dependencies.

Install Carbon Forwarder

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

Run Carbon Forwarder

Use the following command to run Carbon Forwarder.

twistd blueflood-forward

Switch	Description	default
-e	Endpoint to listen on for pickle protocol metrics	tcp:2004
-i	Metrics send interval, in seconds	30.0
-b	Blueflood address	https://localhost:19000
-t	Tenant ID	tenant
-p	Prefix to add to metrics name	metric_prefix
--ttl	Time-to-live value for metrics, in seconds	86400
-u	Keystone user
-k	Keystone key
--auth-url	Keystone token URL

If you don't need authentication, leave the -u/--user command line argument empty (which is the default value).

Send metrics

To send a test metric to the twisted server that you just started, run the following command.

python tests/scripts/sendPickle.py

Modify the script accordingly for your local testing.

Configure Carbon Forwarder

To complete the configuration, pass the following command-line arguments to the twistd daemon.

twistd -n -l - blueflood-forward --help

Logging (optional)

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

References

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 5 months ago