itamae-plugin-recipe-sensu

Itamae plugin to install & configure sensu.

WARNING: Under development yet !

NOTE: This recipe/resource is implemented by referene to sensu/sensu-chef.

Installation

Add this line to your application's Gemfile:

gem 'itamae-plugin-recipe-sensu'

And then execute:

$ bundle

Or install it yourself as:

$ gem install itamae-plugin-recipe-sensu

Usage

Recipe

sensu::redis recipe

Install & configure redis.

# your recipe
include_recipe 'sensu::redis'

NOTE: depends on itamae-plugin-recipe-redis plugin.

sensu::rabbitmq recipe

Install RabbitMQ.

# your recipe
include_recipe 'sensu::rabbitmq'

NOTE: depends on itamae-plugin-recipe-rabbitmq plugin.

sensu::package recipe

Install sensu package.

# your recipe
include_recipe 'sensu::package'

sensu::client_service recipe

Enable sensu-client service.

# your recipe
include_recipe 'sensu::client_service'

sensu::server_service recipe

Enable sensu-server service.

# your recipe
include_recipe 'sensu::server_service'

sensu::api_service recipe

Enable sensu-api service.

# your recipe
include_recipe 'sensu::api_service'

Node

See attribuets/defaults.yml about default values.

Installation

name	description
node.sensu.user	The user who owns all Sensu files and directories. Default 'sensu'
node.sensu.group	The group that owns all Sensu files and directories. Default 'sensu'
node.sensu.use_embedded_ruby	The flag means whether Sensu ruby handlers and plugins use the embedded ruby in the Sensu package, or not use. (default: true)
node.sensu.log_directory	Sensu log directory.
node.sensu.log_level	Sensu log level (default: info)
node.sensu.service_max_wait	How long service scripts should wait for Sensu to start/stop

RabbitMQ

name	description
node.sensu.rabbitmq.host	RabbitMQ host
node.sensu.rabbitmq.port	RabbitMQ port
node.sensu.rabbitmq.vhost	RabbitMQ vhost for Sensu
node.sensu.rabbitmq.user	RabbitMQ user for Sensu
node.sensu.rabbitmq.password	RabbitMQ password for Sensu

• WARNING: This plugin does not support configuration about RabbitMQ ssl. This may be cause of Security Issue.
• WARNING: sensu.core.rabbitmq.port attribute is not used yet...

Redis

name	description
node.sensu.redis.host	Redis host
node.sensu.redis.port	Redis port

Sensu API

name	description
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

Resource

Define a client.

# your recipe
sensu_client 'localhost' do
  address '127.0.0.1'
  subscription_names ['all']
  keepalive(
    thresholds: {
      warning: 10,
      critical: 180
    },
    handlers: ['default'],
    refresh: 180
  )
  additional(
    description: 'sample host'
  )
end

With default attributes, this code create config file to /etc/sensu/conf.d/client.json.

Define a handler

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

With default attributes, this code create config file to /etc/sensu/conf.d/handlers/pagerduty.json.

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

With default attributes, this code create config file to /etc/sensu/conf.d/checks/redis_process.json.

Define a filter

sensu_filter 'environment' do
  attributes(
    client: {
      environment: 'development'
    }
  )
  negate true
end

With default attributes, this code create config file to /etc/sensu/conf.d/filters/environment.json.

Define a mutator

sensu_mutator 'opentsdb' do
  command 'opentsdb.rb'
end

With default attributes, this code create config file to /etc/sensu/conf.d/mutators/opentsdb.json.

Install rubygem with embedded rubygem by sensu package.

sensu_gem 'sensu-plugins-apache' do
  action :install
end

Install 'sensu-plugins-apache' gem with embedded rubygem by sensu package (/opt/sensu/embedded/bin/gem).

Contributing

1. Fork it ( https://github.com/[my-github-username]/itamae-plugin-recipe-sensu/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

License

Copyright 2015 Leonis & Co.

MIT License