carbon-relay-ng

README

carbon-relay-ng

Installation

The Debian way (Ubuntu 12.04 only):

echo "deb http://packages.rcrowley.org precise main" | sudo tee /etc/apt/sources.list.d/rcrowley.list
sudo wget -O /etc/apt/trusted.gpg.d/rcrowley.gpg http://packages.rcrowley.org/keyring.gpg
sudo apt-get update
sudo apt-get -y install carbon-relay-ng

The Go way:

go get github.com/rcrowley/carbon-relay-ng

Usage

carbon-relay-ng [-f] [-l [ip]:port] [pattern]=[ip]:port[...]

• -f: relay only to the first matching route
• -l [ip]:port: listen address (default: 0.0.0.0:2003)

Examples

Send production and staging data to different carbon-cache.py instances:

carbon-relay-ng -f \\.staging\\.=1.2.3.4:2003 \\.production\\.=5.6.7.8:2003

Note the use of -f to relay data only to the first matching route.

Fanout to multiple processors:

carbon-relay-ng =:2003 =5.6.7.8:2003

Repeatedly reading the most recent data points in a Whisper file is silly. This pattern allows alerting and event processing systems to act on the data as it is received.

Documentation

Overview

carbon-relay-ng - route traffic to Graphite's carbon-cache.py