graphite

Description

Installs and configures Graphite. Much of the work in this cookbook reflects work done by Heavy Water Software and Infochimps.

Requirements

Platforms

• Amazon Linux 2013.03
• CentOS 6
• Red Hat 6
• Ubuntu 11.10 (Oneiric)
• Ubuntu 12.04 (Precise)

Cookbooks

• apache2
• build-essential
• logrotate
• python
• yum

Attributes

• node["graphite"]["version"] - Version of Graphite to install.
• node["graphite"]["home"] - Prefix install directory for Graphite.
• node["graphite"]["user"] - User for Graphite and its components.
• node["graphite"]["group"] - Group for Graphite and its components.
• node["graphite"]["twisted_version"] - Attribute to explicitly set a version of Twisted prior to installing Carbon.
• node["graphite"]["port"] - Port on which the graphite webapp should be served
• node["graphite"]["carbon"]["line_receiver_interface"] - IP for the line receiver to bind to.
• node["graphite"]["carbon"]["pickle_receiver_interface"] - IP for the pickle receiver to bind to.
• node["graphite"]["carbon"]["cache_query_interface"] - IP for the query cache to bind to.
• node["graphite"]["carbon"]["log_updates"] - Enable/disable Carbon logging.
• node["graphite"]["carbon"]["max_cache_size"] - Maximum cache size (in points).
• node["graphite"]["carbon"]["max_creates_per_minute"] - Maximum creates per minute (in points).
• node["graphite"]["carbon"]["max_updates_per_second"] - Maximum updates per second (in points).
• node["graphite"]["carbon"]["whisper_dir"] - Location of whisper data files.
• node["graphite"]["dashboard"]["timezone"] - Default dashboard timezone.
• node["graphite"]["dashboard"]["memcache_hosts"] - Array of IP and port pairs for memcached.
• node["graphite"]["dashboard"]["mysql_server"] - MySQL host.
• node["graphite"]["dashboard"]["mysql_port"] - MySQL port.
• node["graphite"]["dashboard"]["mysql_username"] - MySQL username.
• node["graphite"]["dashboard"]["mysql_password"] - MySQL password.
• node["graphite"]["templates"] - Additional template defintions
• node["graphite"]["storage_schemas"] - Array of hashes that define a storage schema. See default attributes for an example.
• node["graphite"]["storage_aggregation"] – Array of hashes that define storage aggregation. See default attributes for an example.

Default Template Definition

• default["graphite"]["templates"]["default"]["background"] = "black"
• default["graphite"]["templates"]["default"]["foreground"] = "white"
• default["graphite"]["templates"]["default"]["majorLine"] = "white"
• default["graphite"]["templates"]["default"]["minorLine"] = "grey"
• default["graphite"]["templates"]["default"]["lineColors"] = "blue,green,red,purple,brown,yellow,aqua,grey,magenta,pink,gold,rose"
• default["graphite"]["templates"]["default"]["fontName"] = "Sans"
• default["graphite"]["templates"]["default"]["fontSize"] = "10"
• default["graphite"]["templates"]["default"]["fontBold"] = "False"
• default["graphite"]["templates"]["default"]["fontItalic"] = "False"

Recipes

• recipe[graphite] will install Graphite and all of its components.
• recipe[graphite::carbon] will install Carbon.
• recipe[graphite::dashboard] will install Graphite's dashboard.
• recipe[graphite::whisper] will install Whisper.

Usage

Graphite's credentials default to username root and password root with an e-mail address going no where. Also, two schemas are provided by default: stats.* for StatsD and a catchall that matches anything.