Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
johnbellone Merge pull request #9 from jjustice6/backup_dir
Turn off backup of the remote_file download.
Latest commit d21727b Jan 30, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
attributes Change plugin dir, stop service started by package install Feb 8, 2016
libraries Turn off backup of the remote_file download. Jan 30, 2017
recipes Updates the copyright year. Jan 13, 2016
templates/default fork process instead of running in foreground Feb 5, 2016
test update test Feb 8, 2016
.codeclimate.yml Updates the readme while preparing for release. Dec 17, 2015
.gitattributes Fixes unit tests so that they go green. Sep 1, 2015
.gitignore Updates the repository template configuration files. Dec 17, 2015
.kitchen.yml Fix the gemfile to include berkshelf. Feb 8, 2016
.rspec
.rubocop.yml SingleSpaceBeforeFirstArg renamed to SpaceBeforeFirstArg apparently Feb 5, 2016
.travis.yml Fix the slack notifications. Jan 14, 2016
.yardopts Rewrites the collectd cookbook to utilize Poise. Aug 31, 2015
Berksfile Removes cookbook dependency for yum-epel and apt. Dec 19, 2015
CHANGELOG.md Fixes service not restarting on update. Jan 13, 2016
Gemfile Fix the gemfile to include berkshelf. Feb 8, 2016
Guardfile Rewrites the collectd cookbook to utilize Poise. Aug 31, 2015
LICENSE Updates the copyright year. Jan 13, 2016
README.md Updates the readme while preparing for release. Dec 17, 2015
Rakefile Rewrites the collectd cookbook to utilize Poise. Aug 31, 2015
metadata.rb Turn off backup of the remote_file download. Jan 30, 2017

README.md

collectd-cookbook

Build Status Code Quality Cookbook Version License

Application cookbook which installs and configures the collectd monitoring daemon.

This cookbook provides a dead-simple installation and configuration of the collectd monitoring daemon. It provides two resources: the first is for managing the collectd system service, and the second is for configuring the daemon's plugins. Additionally, the collectd_plugins cookbook may be used to configure many of the common plugins that ship with the daemon.

It is very important to note that distributions may ship different major versions of the package, but the following platforms are tested using the integration tests via Test Kitchen.

  • Ubuntu ~> 10.04, 12.04, 14.04
  • CentOS ~> 5.8, 6.4, 7.1
  • RHEL ~> 5.8, 6.4, 7.1

Basic Usage

The default recipe in this cookbook simply configures the monitoring daemon to run as a system service. The configuration for this service can be tuned using the node attributes. Additionally, a resource is provided to configure plugins for the daemon. After a plugin has been configured the daemon should be restarted.

Enabling Syslog

One of the simplest plugins to enable is the collectd Syslog plugin which receives log messages from the daemon and dispatches them to the to syslog. This allows the daemon's logs to easily integrate with existing UNIX utilities.

collectd_plugin 'syslog' do
  options do
    log_level 'info'
    notify_level 'OKAY'
  end
end

Advanced Usage

In order to enable the full functionality of some of the more intrusive collectd plugins the daemon will need to run as the root user. Since this is obviously a security risk it is not the default. To achieve this behavior you're required to write a wrapper cookbook which overrides the service user with the proper root user.

node.default['collectd']['service_user'] = node['root_user']
node.default['collectd']['service_group'] = node['root_group']
include_recipe 'collectd::default'
You can’t perform that action at this time.