graphite heka #4

  • By whitmo
  • Latest version (#4)
  • trusty
  • Stable
  • Edge

Description

Graphite consists of a storage backend and a web-based visualization
frontend. Client applications send streams of numeric time-series
data to the Graphite backend (called carbon), where it gets stored
in fixed-size database files similar in design to RRD. The web
frontend provides 2 distinct user interfaces for visualizing this
data in graphs as well as a simple URL-based API for direct graph
generation. Graphite's design is focussed on providing simple
interfaces (both to users and applications), real-time
visualization, high-availability, and enterprise scalability.


Graphite charm

This charm will install Graphite (graph serving webapp) and Carbon
(the metrics sink backend). It's based on the work of the Canonical
CI Engineering team, but does not install, run and expose txtstatsd by
default.

Docs and charm are in transition. Apologizies for rough edges and help
is welcome.

Future

  • Replace carbon & statsd with hekad
  • Enable clustering

Example Usage

Deploy Services

$ make deploy

If you would like to deploy with postgres instead of sqlite3 you will
also need to deploy postgres and add the relation:

$ juju add-relation graphite:pgsql postgres:db

Add a user

Graphite requires a user for saving graphs.

juju ssh graphite-heka/0 -t sudo graphite-manage createsuperuser

You will be prompted for an username, email and password.

Adding data to graphite

[under construction]

Currently, this charm exposes a line-interface for direct carbon input
and udp statsd input if the statsd config option is set to true.

Note about Dependencies

The makefile to run tests requires the following dependencies

  • python-nose
  • python-mock
  • python-flake8

installable via:

$ sudo apt-get install python-nose python-mock python-flake8

NOTE:

Presently the graphite charm only works with one graphite instance deployed or
one graphite and one postgresql instance deployed. It is not presently able to
scale out further than that.

Configuration

wsgi_group
(string) Switch worker process to run as this group. A valid group id (as an int) or the name.
www-data
statsd
(boolean) Install and run txstatsd
extra_repository
(string) The PPA location of the graphite packages. Leave blank to use distro archives.
ppa:canonical-ci-engineering/ci-airline-phase-0
ansible_location
(string) Repository from which to install ansible
ppa:canonical-ci-engineering/ci-airline-phase-0
storage_schema
(string) Default is the storage-schemas example as provided by graphite-carbon. If a custom schema is needed, please place it in the files/ directory and change this to files/<filename.conf>
/usr/share/doc/graphite-carbon/examples/storage-schemas.conf.example
instance_type
(string) Instance type (development, staging or production).
development
secret_key
(string) The web site secret key.
CHANGEME
ansible_ppa
(boolean) Install ansible from a PPA
True
wsgi_user
(string) Switch worker processes to run as this user. User id (as an int) or the name.
www-data
port
(int) Port to use for accessing via gunicorn
8080
base_dir
(string) Base directory for deployment
graphite