README.md

Airbrake handler for Chef

Report Chef exceptions to Airbrake

Works fine with chef versions above 0.9.x

Usage

gem install airbrake_handler

In your chef client file (often placed at /etc/chef/client.rb) put:

require "airbrake_handler"
exception_handlers << AirbrakeHandler.new(:api_key => "your-airbrake-api-key")

You can pass more options to AirbrakeHander initializer, i.e:

AirbrakeHandler.new(:api_key => "your-airbrake-api-key", :framework_env => "production")

Toadhopper options:

• :api_key
• :notify_host

If you want to ignore specific exceptions, you can do this like that:

airbrake_handler = AirbrakeHandler.new(:api_key => "your-airbrake-api-key", :framework_env => "production")
airbrake_handler.ignore << {:class => "SystemExit"}
airbrake_handler.ignore << {:class => "Errno::ECONNRESET", :message => /Connection reset by peer/}

Automation

If you would like to install airbrake_handler by Chef itself, you can use cookbook:

Airbrake Handler Cookbook

Continuous Integration

Contributors

• Anton Mironov
• Benedikt Böhm
• Jeroen Jacobs

Copyright

Copyright (c) 2012 Adam Jacob, Wojciech Wnętrzak See LICENSE for details.