https://github.com/jellybob/chef-gelf

A Chef handler that reports to Graylog2 servers.
https://github.com/jellybob/chef-gelf

Last synced: 26 days ago
JSON representation

A Chef handler that reports to Graylog2 servers.

• Host: GitHub
• URL: https://github.com/jellybob/chef-gelf
• Owner: jellybob
• Created: 2011-07-06T12:50:12.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2011-12-19T10:51:13.000Z (almost 13 years ago)
• Last Synced: 2024-05-21T16:23:47.439Z (7 months ago)
• Language: Ruby
• Homepage:
• Size: 93.8 KB
• Stars: 20
• Watchers: 2
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.rdoc

Awesome Lists containing this project

• awesome-chef - Chef Graylog2/Gelf Handler - A Chef handler that reports to Graylog2 servers. (Chef handlers / Resources - Application configuration)

README

        
= DESCRIPTION:

Provides a Chef handler which can report run status, including any changes that were made, to a Graylog2 server. In the case of failed runs a backtrace will be included in the details reported.

= REQUIREMENTS:

* A Graylog2 server running somewhere.

= USAGE:

This example makes of the chef_handler cookbook, place some thing like this in cookbooks/chef_handler/recipes/gelf.rb and add it to your run list. It also assumes your Graylog2 server has set the attribute rsyslog_server to true.

  log_server = search(:node, "rsyslog_server:true").first

  if log_server

    include_recipe "chef_handler::default"

    gem_package "chef-gelf" do

      action :nothing

    end.run_action(:install)

    

    # Make sure the newly installed Gem is loaded.

    Gem.clear_paths

    require 'chef/gelf'

    

    chef_handler "Chef::GELF::Handler" do

      source "chef/gelf"

      arguments({

        :server => log_server['fqdn']

      })

      supports :exception => true, :report => true

    end.run_action(:enable)

  end

Arguments take the form of an options hash, with the following options:

* :server                 - The server to send messages to.

* :port (12201)           - The port to send on.

* :facility (chef-client) - The facility to report under.

* :host (node.fqdn)       - The host to report messages as coming from.

* :blacklist ({})         - A hash of cookbooks, resources and actions to ignore in the change list.

= BLACKLISTING:

Some resources report themselves as having updated on every run even if nothing changed, or are just things you don't care about. To reduce the amount of noise in your logs these can be ignored by providing a blacklist. In this example we don't want to be told about the GELF handler being activated:

    chef_handler "Chef::GELF::Handler" do

      source "chef/gelf"

      arguments({

        :server => log_server['fqdn'],

        :blacklist => {

          "chef_handler" => {

            "chef_handler" => [ "nothing", "enable" ]

          }

        }

      })

      supports :exception => true, :report => true

    end.run_action(:enable)

= LICENSE and AUTHOR:

Author:: Jon Wood ()

Copyright:: 2011, Blank Pad Development

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.