Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Branch: master
Pull request Compare This branch is 564 commits behind sensu:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
attributes
examples
files/default
libraries
providers
recipes
resources
templates/default
.gitignore
README.md
metadata.rb

README.md

DESCRIPTION

Installs and configures the Sensu server, client, API and dashboard components, installs and configures RabbitMQ and Redis for Sensu. Sensu is a monitoring framework that aims to be simple, malleable, and scalable (https://github.com/sensu/sensu).

COOKBOOK DEPENDENCIES

REQUIREMENTS

SSL Configuration

A data bag with SSL configuration for RabbitMQ is required, details on creating the data bag can be found at https://github.com/sensu/sensu-chef/tree/master/examples/ssl

RECIPES

sensu::default

Installs and configures Sensu and dependencies, but doesn't enable or start any Sensu services.

sensu::server

Configures and enables the Sensu server service, "sensu-server".

sensu::client

Configures and enables the Sensu Client service, "sensu-client".

sensu::api

Configures and enables the Sensu API service, "sensu-api", optionally configures local firewall rules if the firewall attribute is set.

sensu::dashboard

Configures and enables the Sensu dashboard service, "sensu-dashboard", optionally configures local firewall rules if the firewall attribute is set.

sensu::rabbitmq

Installs and configures RabbitMQ with the Sensu vhost, adds SSL support by default and optionally configures local firewall rules if the firewall attribute is set.

sensu::redis

Installs and configures Redis and optionally configures local firewall rules if the firewall attribute is set.

EXAMPLES

Example roles are provided within the examples directory and provide a good overview of a standard Sensu setup. A vagrantfile is also provided for setting up a local test instance using this cookbook. A Cheffile example is also provided for use with Librarian-chef.

ATTRIBUTES

default

  • default.sensu.version - Version of Sensu to install
  • default.sensu.plugin.version - Version of Sensu Plugin gem to install
  • default.sensu.directory - Directory to store Sensu configs (defaults to "/etc/sensu")
  • default.sensu.log.directory - Directory to store Sensu logs (defaults to "/var/log/sensu")
  • default.sensu.ssl - If true, Sensu and RabbitMQ will use SSL encryption (defaults to true)
  • default.sensu.sudoers - If true, adds Sensu sudoers config to /etc/sudoers.d/sensu (defaults to false)
  • default.sensu.firewall - If true, will configure iptables for each sensu component - requires the iptables cookbook to be available (defaults to false)
  • default.sensu.package.unstable - If true, will allow for the installation of unstable packages (defaults to false)

rabbitmq

  • default.sensu.rabbitmq.host - Host for RabbitMQ service (defaults to "localhost")
  • default.sensu.rabbitmq.port - Port for RabbitMQ (defaults to 5671)
  • default.sensu.rabbitmq.vhost - Vhost for RabbitMQ (defaults to "/sensu")
  • default.sensu.rabbitmq.user - User for RabbitMQ vhost authentication (defaults to "sensu")
  • default.sensu.rabbitmq.password - Password for RabbitMQ vhost authentication (defaults to "password")

redis

  • default.sensu.redis.host - Host for Redis service (defaults to "localhost")
  • default.sensu.redis.port - Port for Redis to listen on (defaults to 6379)

api

  • default.sensu.api.host - Host to locate Sensu API (defaults to "localhost")
  • default.sensu.api.port - Port for Sensu API to listen on (defaults to 4567)

dashboard

  • default.sensu.dashboard.host - Host to locate Sensu Dashboard (defaults to "localhost")
  • default.sensu.dashboard.port - Port for Sensu Dashboard to listen on (defaults to 8080)
  • default.sensu.dashboard.user - User for Sensu Dashboard HTTP basic authentication (defaults to "admin")
  • default.sensu.dashboard.password - Password for Sensu Dashboard HTTP basic authentication (defaults to "secret")

SUPPORT

Please visit #sensu on irc.freenode.net and we will be more than happy to help.

Something went wrong with that request. Please try again.