Overview

What Graphite is and is not

Graphite does two things:

1. Store numeric time-series data
2. Render graphs of this data on demand

What Graphite does not do is collect data for you, however there are some :doc:tools </tools> out there that know how to send data to graphite. Even though it often requires a little code, :doc:sending data </feeding-carbon> to Graphite is very simple.

About the project

Graphite is an enterprise-scale monitoring tool that runs well on cheap hardware. It was originally designed and written by Chris Davis_ at Orbitz_ in 2006 as side project that ultimately grew to be a foundational monitoring tool. In 2008, Orbitz allowed Graphite to be released under the open source Apache 2.0 license. Since then Chris has continued to work on Graphite and has deployed it at other companies including Sears_, where it serves as a pillar of the e-commerce monitoring system. Today many large :doc:companies </who-is-using> use it.

The architecture in a nutshell

Graphite consists of 3 software components:

1. carbon - a Twisted_ daemon that listens for time-series data
2. whisper - a simple database library for storing time-series data (similar in design to RRD_)
3. graphite webapp - A Django_ webapp that renders graphs on-demand using Cairo_

:doc:Feeding in your data </feeding-carbon> is pretty easy, typically most of the effort is in collecting the data to begin with. As you send datapoints to Carbon, they become immediately available for graphing in the webapp. The webapp offers several ways to create and display graphs including a simple :doc:URL API </render_api> for rendering that makes it easy to embed graphs in other webpages.

.. _Django: http://www.djangoproject.com/ .. _Twisted: http://www.twistedmatrix.com/ .. _Cairo: http://www.cairographics.org/ .. _RRD: http://oss.oetiker.ch/rrdtool/ .. _Chris Davis: mailto:[email protected] .. _Orbitz: http://www.orbitz.com/ .. _Sears: http://www.sears.com/