View source for Plugin:Carbon

{{Infobox Plugin
  | Name=Carbon/Graphite
  | Type=write
  | Callbacks={{Callback|write}}
  | Status={{deprecated}}
  | FirstVersion={{Version|4.9}}
  | Copyright=''2010'' Gregory Szorc
  | License={{Apache 2.0 License}}
  | Manpage=[https://github.com/indygreg/collectd-carbon/blob/master/README.md README.md] (from project)
}}
The ''Carbon'' plugin writes data collected by ''collectd'' to Carbon, [http://graphite.wikidot.com/start Graphite]'s storage API. It can be found at {{Github|indygreg|collectd-carbon}}

In essence, this is an alternative writer to RRD. Graphite's web UI has very compelling features, such as interactive graphs and dynamic functions.

For [[version 5.1]] and later using the {{Plugin|Write Graphite}} is highly recommended.

== Synopsis ==
 
 <LoadPlugin "python">
   Globals true
 </LoadPlugin>
 
 Import "carbon_writer"
 <Module carbon_writer>
   LineReceiverHost "myhost.mydomain"
   LineReceiverPort 2003
   DeriveCounters true
   TypesDB "/usr/share/collectd/types.db"
 </Module>

== Example graphs ==

Uses Graphite for rendering. See http://graphite.wikidot.com/screen-shots for some examples.

== Caveats ==

=== Globals ===

If using versions [[Version 4.9|4.9]] or [[Version 4.10|4.10]], be sure to load the {{Plugin|Python}} with the ''Globals'' option set to ''true''. Otherwise the Carbon module will ''not'' work properly. The appropriate configuration for loading the ''Python plugin'' is:

 <LoadPlugin "python">
   Globals true
 </LoadPlugin>

Versions before 4.9 don't support this option; it's possible the ''Carbon plugin'' doesn't work with these versions of ''collectd''. [[Version 5.0]] and later will automatically set this flag for the ''Python plugin'', so the above syntax isn't required but still legal.

== See also ==

* {{Plugin|Write Graphite}}<br />C-based plugin to send data to Graphite / Carbon efficiently. Included in ''collectd'' since [[version 5.1]].

== Dependencies ==

* [[Plugin:Python|Python plugin]]

[[Category:Plugins]]
{{DEFAULTSORT:carbon}}