willejs / graphite

Heavy Water Graphite Cookbook for Chef, supported on Ubuntu

Description

Installs and configures Graphite http://graphite.wikidot.com/

Requirements

• Ubuntu 10.04 / Ubuntu 12.04
• Debian
• RHEL and derivatives (Centos, Amazon Linux, Oracle Linux, Scientific Linux)
• Fedora

Attributes

• node['graphite']['version'] - version of graphite to install (defaults to 0.9.10)

• node['graphite']['password'] - password for graphite root user(default to change_me and is only used if encrypted databag isn't)

• node['graphite']['url'] - url of the graphite server (defaults to graphite)

• node['graphite']['url_aliases'] - array of url aliases (defaults to nil)

• node['graphite']['listen_port'] - port to listen on (defaults to 80)

• node['graphite']['ssl']['enabled'] - enable ssl in the apache2 vhost

• node['graphite']['ssl']['cipher_suite'] - the cipher suite to use if ssl is enabled

• node['graphite']['ssl']['certificate_file'] - the path to the certificate file if ssl is enabled

• node['graphite']['ssl']['certificate_key_file'] - the path to the vertificate key file if ssl is enabled

• node['graphite']['base_dir'] = "/opt/graphite"

• node['graphite']['doc_root'] = "/opt/graphite/webapp"

• node['graphite']['storage_dir'] = "/opt/graphite/storage"

• node['graphite']['django_root'] = "@DJANGO_ROOT@" - configurable path to your django installation

• node['graphite']['timezone'] - Set the timezone for the graphite web interface, defaults to America/Los_Angeles

• node['graphite']['whisper']['uri'] - download url for whisper

• node['graphite']['whisper']['checksum'] - checksum of the whisper download

• node['graphite']['graphite_web']['uri'] - download url for the graphite web ui

• node['graphite']['graphite_web']['checksum'] - checksum for the graphite web ui download

• node['graphite']['carbon']['uri'] - download url for carbon

• node['graphite']['carbon']['checksum'] - checksum for the carbon download

• node['graphite']['carbon']['line_receiver_interface'] - line interface IP (defaults to 0.0.0.0)

• node['graphite']['carbon']['line_receiver_port'] - line interface port (defaults to 2003)

• node['graphite']['carbon']['pickle_receiver_interface'] - pickle receiver IP (defaults to 0.0.0.0)

• node['graphite']['carbon']['pickle_receiver_port'] - pickle receiver port (defaults to 2004)

• node['graphite']['carbon']['cache_query_interface'] - cache query IP (defaults to 0.0.0.0)

• node['graphite']['carbon']['cache_query_port'] - cache query port (defaults to 7002)

• node['graphite']['carbon']['max_cache_size'] - max size of the carbon cache (defaults to "inf")

• node['graphite']['carbon']['max_creates_per_second'] - max number of new metrics to create per second (defaults to "inf")

• node['graphite']['carbon']['max_updates_per_second'] - max updates to carbon per second (defaults to "1000")

• node['graphite']['carbon']['service_type'] - init service to use for carbon (defaults to runit)

• node['graphite']['carbon']['log_whisper_updates'] - log updates to whisper (defaults to false)

• node['graphite']['encrypted_data_bag']['name'] - The name of the encrypted data bag containing the default password for the graphite "root" user. If this attribute is set it will not use node['graphite']['password'].

• default['graphite']['web_server'] - defaults to apache. Anything else will use uswsgi instead of apache

• default['graphite']['user_account'] - user (default node['apache']['user'])

• default['graphite']['group_account'] - group (default node['apache']['group'])

• default['graphite']['create_user']- should the user be created, boolean (defaults to false)

Data Bags

This cookbook optionally uses an encrypted data bag to store the graphite password. If this data bag is not present the cookbook will use node['graphite']['password'] instead. To use the encrypted data bag set node['graphite']['encrypted_data_bag']['name'] with the name of the data bag you wish to use.

Usage

recipe[graphite] should build a stand-alone Graphite installation.

recipe[graphite::ganglia] integrates with Ganglia. You'll want at least one monitor node (i.e. recipe[ganglia]) node to be running to use it.