5-minute Overview ================= testing... 1.0 docs 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 ` out there that know how to send data to graphite. Even though it often requires a little code, :doc:`sending data ` 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 ` 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 ` 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 ` 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:chrismd@gmail.com .. _Orbitz: http://www.orbitz.com/ .. _Sears: http://www.sears.com/