cookbook 'collectd', '= 2.2.0'
collectd (5) Versions 2.2.0 Follow12
Installs and configures the collectd monitoring daemon.
cookbook 'collectd', '= 2.2.0', :supermarket
knife supermarket install collectd
knife supermarket download collectd
collectd-cookbook
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](recipes/default.rb) 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](attributes/default.rb). 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.
ruby
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.
ruby
node.default['collectd']['service_user'] = node['root_user']
node.default['collectd']['service_group'] = node['root_group']
include_recipe 'collectd::default'
Change Log
All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning.
Unreleased
2.2
Features
- PR#7 Adds custom resource for managing template plugin files.
2.1.2
Bug Fixes
- PR#6 Fix errors with multiple value configurations.
2.1.1
Bug Fixes
- PR#5 Use upgrade action on Solaris platform.
2.1
Features
- PR#4 Support for Solaris 11 platform.
2.0
Major Features
- Adds custom resources for managing service and configuration separately.
- Uses Poise and Poise Service libraries to provide platform independence.
Foodcritic Metric
2.2.0 passed this metric
2.2.0 passed this metric