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

RSS

sensu (66) Versions 2.2.0

Installs/Configures Sensu

Policyfile
Berkshelf
Knife
cookbook 'sensu', '= 2.2.0', :supermarket
cookbook 'sensu', '= 2.2.0'
knife supermarket install sensu
knife supermarket download sensu
README
Dependencies
Changelog
Quality 0%

DESCRIPTION

Provides LWRP's and service recipes to install and configure
Sensu, a monitoring framework.

This cookbook provides the building blocks for creating a monitoring
cookbook specific to your environment (wrapper). Without such a
wrapper, no Sensu configuration files will be created for your nodes.

An example wrapper cookbook can be found
HERE.

How to Write Reusable Chef Cookbooks

TESTING

This cookbook comes with a Gemfile, Cheffile, and a Vagrantfile for
testing and evaluating Sensu.

cd examples
gem install bundler
bundle install
librarian-chef install
vagrant up
vagrant ssh

COOKBOOK DEPENDENCIES

REQUIREMENTS

SSL configuration

Running Sensu with SSL is recommended; this cookbook uses a data bag
sensu, with an item ssl, containing the SSL certificates required.
Sensu data bag items may be encrypted. This cookbook comes with a tool
to generate the certificates and data bag item. If the integrity of
the certificates is ever compromised, you must regenerate and redeploy
them.

cd examples/ssl
./ssl_certs.sh generate
knife data bag create sensu

Use the plain-text data bag item:

knife data bag from file sensu ssl.json

Or, encrypt it with your data bag secret. See Encrypt a Data
Bag
for
more information.

knife data bag --secret-file /path/to/your/secret from file sensu ssl.json
./ssl_certs.sh clean

RECIPES

sensu::default

Installs Sensu and creates a base configuration file, intended to be
extended. This recipe must be included before any of the Sensu LWRP's
can be used. This recipe does not enable or start any services.

sensu::rabbitmq

Installs and configures RabbitMQ for Sensu, from configuring SSL to
creating a vhost and credentials. This recipe relies heavily on the
community RabbitMQ cookbook LWRP's.

sensu::redis

Installs and configures Redis for Sensu. This recipe uses the
RedisIO cookbook and installs Redis from source.

sensu::server_service

Enables and starts the Sensu server.

sensu::client_service

Enables and starts the Sensu client.

sensu::api_service

Enables and starts the Sensu API.

ATTRIBUTES

Installation

node.sensu.version - Sensu build to install.

node.sensu.use_unstable_repo - If the build resides on the
"unstable" repository.

node.sensu.directory - Sensu configuration directory.

node.sensu.log_directory - Sensu log directory.

node.sensu.log_level - Sensu log level (eg. "warn").

node.sensu.use_ssl - If Sensu and RabbitMQ are to use SSL.

node.sensu.use_embedded_ruby - If Sensu Ruby handlers and plugins
use the embedded Ruby in the Sensu package.

node.sensu.init_style - Style of init to be used when configuring
Sensu services, "sysv" and "runit" are currently supported.

node.sensu.service_max_wait - How long service scripts should wait
for Sensu to start/stop.

RabbitMQ

node.sensu.rabbitmq.host - RabbitMQ host.

node.sensu.rabbitmq.port - RabbitMQ port, usually for SSL.

node.sensu.rabbitmq.ssl - RabbitMQ SSL configuration, DO NOT EDIT THIS.

node.sensu.rabbitmq.vhost - RabbitMQ vhost for Sensu.

node.sensu.rabbitmq.user - RabbitMQ user for Sensu.

node.sensu.rabbitmq.password - RabbitMQ password for Sensu.

Redis

node.sensu.redis.host - Redis host.

node.sensu.redis.port - Redis port.

Sensu API

node.sensu.api.host - Sensu API host, for other services to reach it.

node.sensu.api.bind - Sensu API bind address.

node.sensu.api.port - Sensu API port.

LWRP'S

Define a client

sensu_client node.name do
  address node.ipaddress
  subscriptions node.roles + ["all"]
  additional(:cluster => node.cluster)
end

Define a handler

sensu_handler "pagerduty" do
  type "pipe"
  command "pagerduty.rb"
  severities ["ok", "critical"]
end

Define a check

sensu_check "redis_process" do
  command "check-procs.rb -p redis-server -C 1"
  handlers ["default"]
  subscribers ["redis"]
  interval 30
  additional(:notification => "Redis is not running", :occurrences => 5)
end

Define a filter

sensu_filter "environment" do
  attributes(:client => {:environment => "development"})
  negate true
end

Define a mutator

sensu_mutator "opentsdb" do
  command "opentsdb.rb"
end

Define a custom configuration snippet

sensu_snippet "irc" do
  content(:uri => "irc://sensu:password@irc.freenode.net:6667#channel")
end

SUPPORT

Please visit sensuapp.org/support for details on community and commercial
support resources, including the official IRC channel.

0.6.0 - TBD

Non-backwards compatible changes

Redis recipe, switched to redisio cookbook. The cookbook is available
on the OpsCode community site & has better platform/release support.

Foodcritic Metric
            

2.2.0 failed this metric

FC015: Consider converting definition to a LWRP: /tmp/cook/6763dad78d75ac9bff17419d/sensu/definitions/silence_check.rb:1
FC015: Consider converting definition to a LWRP: /tmp/cook/6763dad78d75ac9bff17419d/sensu/definitions/silence_client.rb:1
FC023: Prefer conditional attributes: /tmp/cook/6763dad78d75ac9bff17419d/sensu/definitions/silence_check.rb:19
FC023: Prefer conditional attributes: /tmp/cook/6763dad78d75ac9bff17419d/sensu/definitions/silence_client.rb:14
FC023: Prefer conditional attributes: /tmp/cook/6763dad78d75ac9bff17419d/sensu/recipes/_windows.rb:35