Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


graphite (44) Versions 1.0.4

Installs/Configures graphite

cookbook 'graphite', '= 1.0.4', :supermarket
cookbook 'graphite', '= 1.0.4'
knife supermarket install graphite
knife supermarket download graphite
Quality 50%

Graphite Cookbook

Build Status
Code Climate
Cookbook Version


Library cookbook for installation and configuration of Graphite via Chef

Consult the Graphite documentation for more information:



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


  • Chef 11+


  • ark
  • java
  • windows


default attributes
for platform specific packages installed.

  • node['graphite']['version'] - package version to install, defaults to '0.9.12'
  • node['graphite']['twisted_version'] - twisted version to pin to, defaults to '13.1'
  • node['graphite']['django_version'] - django version to use, defaults to '1.5.5'
  • node['graphite']['user'] - graphite user, 'graphite'
  • node['graphite']['group'] - graphite group, 'graphite'
  • node['graphite']['base_dir'] - default base dir, '/opt/graphite'
  • node['graphite']['doc_root'] - doc root for graphite-web, '/opt/graphite/webapp'
  • node['graphite']['storage_dir'] - storage dir, '/opt/graphite/storage'
  • node['graphite']['install_type'] - 'package' or 'source'. Setting this to source will use latest github master branch
  • default['graphite']['package_names'] - package name hash, indexed by 'install_type' attribute.
  • default['graphite']['graph_templates'] - graphite template config hash

Adjusting package source location

You can override the
node['graphite']['package_names'][#{name}]['source'] attribute,
where #{name} is one of whisper, carbon or graphite_web, to
set a custom install path. By default a source install will use the
github master branch.



No-op, assuming cookbook inclusion in a custom wrapper.


Just install all packages, carbon and web


Install all carbon packages, setup the graphite user, storage paths
and write the carbon configuration. Does not start any services.


Set up just about everything for graphite web, except configure it and
start the service. Use the graphite_web_config resource and the
uwsgi recipe for those two things.

Some of this weirdness may not really be needed, so send us a PR if
you fix it before us. For example, I'd love some way to remove that
execute block for selinux and there's probably a better way to manage
all those files and directories.


Start a uwsgi runit service for graphite-web. That's it.

Various internal recipes

View the code for additional stub recipes that perform smaller pieces
of functionality such as setup the user or install specific packages,
the all begin with an underscore _.

It's like a treasure hunt.

Custom Resources

Carbon daemons

Management for the various
Carbon services which
receive your metrics and write them to disk.

  • graphite_service: sets up a carbon service with runit, essentially a glorified runit_service. Carbon configuration should be defined first with one of the graphite_carbon_* resources. Multiple daemons can be run by using multiple resources with names such as cache:a, cache:b, etc..
  • graphite_carbon_aggregator: data driven resource for carbon-aggregator configuration
  • graphite_carbon_cache: data driven resource for carbon-cache configuration
  • graphite_carbon_relay: data driven resource for carbon-cache configuration


Whisper is
pretty much a requirement right now, so these resources assume whisper
libraries should be installed. Feel free to implement something else in
your own wrapper if you live on the edge and prefer Ceres.

  • graphite_storage: makes a directory intended for graphite storage, installs whisper
  • graphite_storage_schema: data driven resource for storage schema

Graphite Web

Write the configuration file for Graphite Web

  • graphite_web_config: data driven python config file writer for graphite web. Assumes the whole file is managed, typically this is the path to Custom python code can be placed in the optional 'dynamic template', by default a file named '' that is optimistically loaded if present.

Yes it's writing python via ruby.

A runit service definition is provided to start a uwsgi process, but note that choice of web server for proxying to the application server is left up to you. No more hard Apache dependency!


Due to the graphite config file format, the data driven resources use
an accumulator pattern to find the appropriate resources in the run
context and extract provided configuration data. You should never need
to use these directly, but you're welcome to go crazy.

  • graphite_carbon_conf_accumulator: lookup named carbon resources in run context and gather config
  • graphite_storage_conf_accumulator: lookup named storage schema resources in run context and gather config

If you look at the
example cookbook recipe
you probably notice that many of the resources simply take a single config
attribute, which is basically a hash of the configuration to be written.

This can come from attributes in a wrapper cookbook or via data bags
if you like. Be as creative as you can tolerate.

Accumulator pattern came from excellent work by Mathieu Sauve-Frankel


It's a library cookbook, intended to be used in your custom wrapper
cookbook to behave as needed. It's the building materials, not the

We have purposefully left out web server configuration to remove the
dependency, so you're free to use whatever works in your environment.
This avoids the need for this cookbook to keep up to date with
configuration that isn't really graphite specific.

For example usage consult the reference cookbook example

Feel free to ask us questions anytime on irc: #heavywater on freenode


You can find example usage in the graphite_example cookbook that is included in the git repository.

Data Bags

Sure, use em if you like. Even encrypt them.

Amazon Web Services

Due to the old version of Chef used on Amazon Web Services in order to
successfully run this cookbook you may need to add the
recipe to your run list before the graphite recipe.

Development / Contributing

  • Source hosted at [GitHub][repo]
  • Report issues/questions/feature requests on [GitHub Issues][issues]

Pull requests are very welcome! Make sure your patches are well tested.
Ideally create a topic branch for every separate change you make. For

  1. Fork the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Write some tests, see ChefSpec
  4. Commit your awesome changes (git commit -am 'Added some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request and tell us about it your changes.


This file is used to list changes made in each version of the graphite cookbook.


  • Syntax and styling updates
  • Use full Twisted version number
  • Manage graphite nofile ulimit
  • Fixes carbon source
  • Adds License and Code of Conduct ### Known Issues
  • Reordering of Carbon .ini 241
  • Graphite web timeout when restarting 224


  • README improvements to address resource usage and removal of Apache dependency (@webframp, #187)
  • restart graphite-web in graphite_example sample recipe (@obazoud, #182)
  • remove unused ['graphite']['web_server'] attribute (@obazoud, #181)


  • Readme improvements.


Breaking Changes

  • Initial release of graphite library style cookbook. Complete rewrite of cookbook to provide reusable resources. Breaks backward compatibility with cookbook version prior 1.0. (@webframp, @fnichol, @agoddard)

Collaborator Number Metric

1.0.4 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

1.0.4 passed this metric

Foodcritic Metric

1.0.4 failed this metric

FC052: Metadata uses the deprecated "suggests" keyword: graphite/metadata.rb:23
FC052: Metadata uses the deprecated "suggests" keyword: graphite/metadata.rb:24
FC052: Metadata uses the deprecated "suggests" keyword: graphite/metadata.rb:25
FC066: Ensure chef_version is set in metadata: graphite/metadata.rb:1
FC069: Ensure standardized license defined in metadata: graphite/metadata.rb:1
FC085: Resource using new_resource.updated_by_last_action to converge resource: graphite/libraries/provider_carbon_conf_accumulator.rb:51
FC085: Resource using new_resource.updated_by_last_action to converge resource: graphite/libraries/provider_storage_conf_accumulator.rb:49
FC085: Resource using new_resource.updated_by_last_action to converge resource: graphite/providers/carbon_cache.rb:40
FC085: Resource using new_resource.updated_by_last_action to converge resource: graphite/providers/service_runit.rb:56
FC085: Resource using new_resource.updated_by_last_action to converge resource: graphite/providers/storage.rb:59
FC085: Resource using new_resource.updated_by_last_action to converge resource: graphite/providers/web_config.rb:46
FC122: Use the build_essential resource instead of the recipe: graphite/recipes/_carbon_packages.rb:20
Run with Foodcritic Version 14.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

1.0.4 passed this metric

Testing File Metric

1.0.4 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

1.0.4 passed this metric