This cookbook provides two resources and providers to install and configure Graphite Carbon {Cache:Relay} under virtualenv. Currently supported resources:

• Carbon Relay (relay)
• Carbon Cache (cache)

1. Ubuntu 12.04 Has been tested, other versions may work.
2. Python Provides virtualenv support and the pip provider
3. graphite Installs the Graphite Web Service to display Metrics stored by Carbon Cache

The default recipe does absolutely nothing. It is not intended to do anything

This cookbook provides two resource and corresponding providers.

Installs Carbon Cache from either Pypi or Github

Actions:

• install - installs carbon-cache from Pypi
• git - installs carbon-cache via git

Attribute Parameters:

• carbon_stable_base_git_uri - String - default - https://github.com/graphite-project/
• carbon_stable_packages - Hash - default - { "whisper" => "0.9.x", "carbon" => "0.9.x" }
• graphite_home - String - default - /opt/graphite
• user - String - default - graphite
• carbon_packages - Hash - { "whisper" => "0.9.10", "carbon" => "0.9.10" }

Installs and Configures Carbon Cache from

Actions:

• create - configures carbon-cache
• start - starts carbon-cache
• stop - stops carbon-cache

Attribute Parameters:

• cookbook - String - default - carbon - cookbook to fetch all templates from
• python_interpreter - String - default - python2.7
• carbon_template_source - String - default - carbon.conf.erb
• storage_template_source - String - default - storage-schemas.conf.erb
• cpu_affinity - String
• options - Hash
• user - String - default - graphite
• group - String - default - graphite
• max_cache_size - String - default - inf
• max_updates_per_second - Fixnum - default - 5000
• max_creates_per_minute - Fixnum - default - 100
• line_listner - Hash - default - {"line_receiver_interface" => "0.0.0.0", "line_receiver_port" => 2003 }
• pickle_listner - Hash - default - {"pickle_receiver_interface" => "0.0.0.0", "pickle_receiver_port" => 2004 }
• udp_listner - Hash - default - {"enable_udp_listner" => "False", "udp_receiver_interface" => "0.0.0.0", "udp_receiver_port" => 2003 }
• use_insecure_pickler - String - default - False
• use_flow_control - String - default - True
• cache_query - Hash - default - {"cache_query_interface" => "0.0.0.0", "cache_query_port" => 7002 }
• log_updates - String - default - False
• whisper_autoflush - String - default - False
• enable_amqp - String - default - False
• amqp_verbose - String - default - False
• amqp - Hash - default - {"amqp_host" => "localhost", "amqp_port" => 5672, "amqp_vhost" => "/", "amqp_user" => "guest", "amqp_password" => "guest", "amqp_exchange" => "graphite", "amqp_metric_name_in_body" => "False" }
• bind_patterns - Array - default - "#"
• graphite_home - String - default - /opt/graphite
• carbon_packages - Hash - default - { "whisper" => "0.9.10", "carbon" => "0.9.10" }
• carbon_instance - String - default - a
• storage_schema - Hash - default - { :all => { :pattern => "(.*)", :retentions => "10s:90d, 60s:1y" } }
• storage_aggregation - Hash - default - { }
• local_data_dir - String - default - /opt/graphite/storage/whisper
• init_style - String - default - runit

Configures Carbon Relay

Actions:

• create - configures carbon-relay
• start - starts carbon-relay
• stop - stops carbon-relay
• disable - disables carbon-relay

Attribute Parameters:

• cookbook - String - carbon - name of the cookbook to get templates from
• options - Hash
• relay_rules - Hash - default - {"default" => { "default" => "true"' - "destinations" => ["127.0.0.1:2004"]' - "continue" => "false"' - "pattern" => String.new } }
• line_listner - Hash - default - {"line_receiver_interface" => "0.0.0.0"' - "line_receiver_port" => 2013 }
• pickle_listner - Hash - default {"pickle_receiver_interface" => "0.0.0.0"' - "pickle_receiver_port" => 2014 }
• relay_method - String - default - consistent-hashing
• replication_factor - Fixnum - default - 1
• destinations - Array' - default - ["127.0.0.1:2004:a"]
• max_datapoints_per_message - Fixnum - default 500
• max_queue_size - Fixnum - default - 10000
• use_flow_control - String - default - True
• graphite_home - String - default - /opt/graphite - location to install graphite to
• relay_instance - String - default - a
• user - String - default - graphite - username to install graphite under
• group - String - default - graphite - group to install graphite under
• python_interpreter - String - default - python2.7
• relay_template_source - String - default - carbon-relay.conf.erb
• relay_init_template - String - default - carbon-relay.init.erb
• init_style - String' - default - runit
• cpu_affinity - String - Specifies which cpu to bind the carbon-relay process to
• relay_rules_template_source - String - default - relay-rules.conf.erb

This is the most basic example you are not limited by this example.

cd chef-repo/cookbooks
git submodule add git://github.com/damm/carbon.git
git submodule add git://github.com/damm/graphite.git
COOKBOOK=graphite_infra rake new_cookbook

• The cookbook named graphite_infra must depend on the carbon cookbook.

  carbon_cache "my_carbon" do action [:install,:config,:start]
  cpu_affinity "1"
  end
  carbon_relay "sample" do
  action [:config,:start]
  end

• For better examples please review our Tests

Author:: Scott M. Likens [email protected]

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.