Difference between revisions of "Plugin:Write Graphite"

From collectd Wiki
Jump to: navigation, search
(See also: Add SSC Serv.)
Line 50: Line 50:
* [http://graphite.wikidot.com/ Graphite website]
* [http://graphite.wikidot.com/ Graphite website]
* Initial development project: {{Github | user=jssjr | repository=collectd-write_graphite}}
* Initial development project: {{Github | user=jssjr | repository=collectd-write_graphite}}
* [https://ssc-serv.com/graphite.shtml Graphite plugin] of [[SSC Serv]], a ''Windows'' service using a compatible naming schema.
{{DEFAULTSORT:Write graphite}}
{{DEFAULTSORT:Write graphite}}

Revision as of 16:20, 15 January 2014

Write Graphite plugin
Type: write
Callbacks: config, flush, write
Status: supported
First version: 5.1
Copyright: 2012 Pierre-Yves Ritschard
2011 Scott Sanders
2009 Paul Sadauskas
2009 Doug MacEachern
2007–2012 Florian Forster
License: GPLv2
Manpage: collectd.conf(5)
List of Plugins

The Write Graphite plugin stores values in Carbon, the storage layer of Graphite.

The plugin aims to be very efficient. It keeps the TCP connection to Carbon open in order to minimize the connection handshake overhead. It buffers the data in a buffer to send many lines at once, rather than generating lots of small network packets. The size of this buffer (1428 bytes) is dimensioned so that the buffer as well as the TCP and IP header fit into one Ethernet frame and can (hopefully) be delivered without fragmentation.


LoadPlugin "write_graphite"
<Plugin "write_graphite">
   Host "localhost"
   Port "2003"
   #Prefix "collectd."
   #Postfix ""
   #Protocol "udp"
   EscapeCharacter "_"
   SeparateInstances true
   StoreRates false
   AlwaysAppendDS false

Example data

Data is sent as one metric per line, where each data source is on its own line. Each line consists of three fields: a name, the actual value, and the timestamp in epoch. The following data was generated with StoreRates set to true:

myhost_example_com.cpu-2.cpu-idle 98.6103 1329168255
myhost_example_com.cpu-2.cpu-nice 0 1329168255
myhost_example_com.cpu-2.cpu-user 0.800076 1329168255
myhost_example_com.cpu-2.cpu-wait 0.400054 1329168255
myhost_example_com.cpu-2.cpu-system 0.20002 1329168255
myhost_example_com.cpu-2.cpu-softirq 0 1329168255
myhost_example_com.cpu-2.cpu-interrupt 0 1329168255


  • None

See also