alert_tweeter 1.0.0

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.yardoc

data/.rvmrc

@@ -0,0 +1 @@
+rvm ruby-1.9.2@alert_tweeter --create

data/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+source "http://localhost:50000"
+source "http://rubygems"
+
+# Specify your gem's dependencies in alert_tweeter.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2012 by Jonathan D. Simms
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,101 @@
+# Alert tweeter
+
+Hate paying _[insert provider here]_ the __OUTRAGEOUS__ texting rates you need if you're sending Nagios alerts via SMS? 
+
+Yeah, so do I. 
+
+Here's a fairly simple way to send your nagios alerts to your mobile device via Twitter. The iOS twitter app will alert when you get direct messages (you may need to run it first, so that it's in "sleep mode"), so instead of paying [$150/MB](https://twitter.com/#!/slyphon/status/160849711937490944) in SMS rates, you're piggybacking off your somewhat more generous data plan.
+
+Unless you *love* your wireless carrier, or perhaps in the case of AT&T [feel sorry for them][whining babies], use alert tweeter.
+
+
+[whining babies]: http://www.pcworld.com/businesscenter/article/184179/atandt_now_blaming_customers_for_its_problems.html 
+
+## Configuration
+
+* You will probably want to set up a dedicated twitter account that represnts your nagios.
+* You'll need to [register an app](https://dev.twitter.com/apps).
+* People who need to receive tweets will likely need to follow the tweeter.
+* You'll need a YAML file like:
+
+```
+---
+app_name: your-clever-app-name
+notify_users:
+- annoy
+- all_of_these
+- twitter_uesrs
+auth:
+  consumer_key: YOUR_CONSUMER_KEY
+  consumer_secret: YOUR_CONSUMER_SECRET
+  oauth_token: YOUR_OAUTH_TOKEN
+  oauth_token_secret: YOUR_OAUTH_TOKEN_SECRET
+```
+
+then in your nagios config, you'll need something like:
+
+```
+define command {
+  command_name service-notify-by-twitter
+  command_line /usr/local/rvm/bin/rvm-exec 1.9.2 tweet-alert \
+      --config=/path/to/the/config.yml \
+      --notification_type=$NOTIFICATIONTYPE$ \
+      --event_state=$SERVICESTATE$ \
+      --event_state_type=$SERVICESTATETYPE$ \
+      --host_name=$HOSTALIAS$ \
+      --host_address=$HOSTADDRESS$ \
+      --service_desc=$SERVICEDESC$ \
+      --service_attempt=$SERVICEATTEMPT$ \
+      --service_duration_sec=$SERVICEDURATIONSEC$ \
+      --service_output="$SERVICEOUTPUT$" 
+}
+
+define command {
+  command_name host-notify-by-twitter
+  command_line /usr/local/rvm/bin/rvm-exec 1.9.2 tweet-alert \
+      --config=/path/to/the/config.yml \
+      --notification_type=$NOTIFICATIONTYPE$ \
+      --event_state=$HOSTSTATE$  \
+      --event_state_type=$HOSTSTATETYPE$ \
+      --host_name=$HOSTALIAS$ \
+      --host_address=$HOSTADDRESS$ \
+      --host_attempt=$HOSTATTEMPT$ \
+      --host_duration_sec=$HOSTDURATIONSEC$ \
+      --host_output="$HOSTOUTPUT$"
+}
+
+define contact {
+  name                            twitter-contact
+  service_notification_period     24x7
+  host_notification_period        24x7
+  service_notification_options    w,u,c,r,f,s
+  host_notification_options       d,u,r,f,s
+  service_notification_commands   service-notify-by-twitter
+  host_notification_commands      host-notify-by-twitter
+  register                        0
+}
+
+define contactgroup {
+  contactgroup_name admins-twitter
+  alias             Sysamdin Twitter
+  members           twitter-dummy
+}
+
+# as of alert_tweeter-0.0.2 the contacts are determined by the alert_tweeter.yml file
+# managed by chef in the icinga recipe
+define contact {
+  use                           twitter-contact
+  contact_name                  twitter-dummy
+  service_notification_options  c,r,f
+  host_notification_options     d,u,r,f
+  #                             ^^^^^^^--- ha! twitter dummy! durf! get it!?
+}
+```
+
+(GAH! I *hate* nagios! could they make it MORE verbose, error-prone, and annoying?!)
+
+Obviously replace `--config=/path/to/the/config.yml` with the path to the *actual* config. 
+
+I use rvm. If you don't, or if you're weird and like rbenv, you'll need to adjust the above commands.
+
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/alert_tweeter.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "alert_tweeter/version"
+
+Gem::Specification.new do |s|
+  s.name        = "alert_tweeter"
+  s.version     = AlertTweeter::VERSION
+  s.authors     = ["Jonathan D. Simms"]
+  s.email       = ["slyphon@gmail.com"]
+  s.homepage    = "https://github.com/slyphon/alert_tweeter"
+  s.summary     = %q{Nagios alerts go to twitter}
+  s.description = s.summary + "\n"
+
+  s.rubyforge_project = "alert_tweeter"
+
+  s.files         = `git ls-files`.split("\n").reject{|n| n =~ /\.gem$/}
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency 'twitter',       '~> 2.0.2'
+  s.add_runtime_dependency 'slop',          '~> 2.4.2'
+  s.add_runtime_dependency 'activesupport', '~> 3.1.0'
+  s.add_runtime_dependency 'i18n'
+end

data/bin/tweet-alert

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require File.expand_path('../../lib/alert_tweeter', __FILE__)
+
+AlertTweeter::Command.run!(*ARGV)
+

data/lib/alert_tweeter.rb

@@ -0,0 +1,136 @@
+$LOAD_PATH.unshift(File.expand_path('..', __FILE__)).uniq!
+
+require "alert_tweeter/version"
+
+require 'slop'
+require 'twitter'
+
+%w[ core_ext/module/attribute_accessors
+    core_ext/class/attribute_accessors 
+    core_ext/string/strip
+    core_ext/module/aliasing
+].each do |p|
+  require "active_support/#{p}"
+end
+
+module AlertTweeter
+  mattr_accessor :root, :instance_writer => false 
+
+  DEFAULT_CONFIG_PATH = '/etc/alert_tweeter.yml'
+
+  class Command
+    attr_reader :opts
+
+    def self.run!(*a, &b)
+      new.run!(*a, &b)
+    end
+
+    def config
+      @config ||= YAML.load_file(opts[:config])
+    end
+
+    def notify_users
+      @config.fetch('notify_users')
+    end
+
+    def configure_client!(path)
+      require 'yaml'
+
+      hash = config.fetch('auth')
+
+      Twitter.configure do |c|
+        %w[consumer_key consumer_secret oauth_token oauth_token_secret].each do |k|
+          c.__send__(:"#{k}=", hash.fetch(k))
+        end
+      end
+    end
+
+    def timestamp
+      Time.at(timet.to_i).strftime('%Y-%m-%d %H:%M:%S')
+    end
+
+    def send_notification(message)
+      notify_users.each do |user|
+        Twitter.direct_message_create(user, message)
+      end
+    end
+
+    def service_notify!
+      send_notification <<-EOS.strip_heredoc[0...140]
+        #{notification_type} #{host_name}/#{service_desc} #{event_state}
+        #{timestamp}
+        #{service_output}
+      EOS
+    end
+
+    def host_notify!
+      send_notification <<-EOS.strip_heredoc[0...140]
+        #{notification_type} #{host_name} #{event_state}
+        #{timestamp}
+        #{host_output}
+      EOS
+    end
+
+    def run!(*args)
+      args << '-h' if args.empty?
+
+      @opts = Slop.parse!(args, :strict => true, :help => true) do
+        banner <<-EOS.strip_heredoc
+          Usage: #{File.basename($0)} [opts] 
+
+          Will direct-message the configured users about service problems. Command-line options
+          are provided that more-or-less match their nagios macro counterparts.
+        EOS
+
+        on :f, :config,                 'path to the config file to use', true, :default => DEFAULT_CONFIG_PATH
+
+        on :n, :notification_type,      'string describing the type of notification being sent', true
+
+        on :s, :event_state,            'string indicating the state of event-generating object', true, :default => 'UNKNOWN'
+        on :y, :event_state_type,       'HARD or SOFT', true
+
+        on :H, :host_name,              'host name where the alert is triggered', true, :required => true
+        on :a, :host_address,           'IP address of the host', true
+        on :A, :host_attempt,           'number of the current re-check', true, :as => :integer
+        on :O, :host_output,            'output from host check', true
+        on :U, :host_duration_sec,      'number of seconds the host has spent in the current state', true, :as => :integer
+
+        on :d, :service_desc,           'description of the service', true
+        on :a, :service_attempt,        'number of the current re-check', true, :as => :integer
+        on :u, :service_duration_sec,   'number of seconds the service has been in the current state', true, :as => :integer
+        on :o, :service_output,         'first line of text output from the last service check', true
+
+        on :t, :timet,                  'seconds since unix epoch', true, :as => :integer, :default => Time.now.to_i
+      end
+
+      if opts.help?
+        $stderr.puts opts.help
+        exit 1
+      end
+
+      unless opts[:service_output] or opts[:host_output]
+        $stderr.puts "ERROR: You must specify either a --service_output or --host_output option"
+        exit 1
+      end
+
+      configure_client!(opts[:config])
+
+      if opts[:service_output]
+        service_notify!
+      else
+        host_notify!
+      end
+    end
+
+    private
+      def method_missing(name, *a, &b)
+        namesym = name.to_sym
+        if val = opts[namesym]
+          return val
+        else
+          super
+        end
+      end
+  end
+end
+

data/lib/alert_tweeter/version.rb

@@ -0,0 +1,3 @@
+module AlertTweeter
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification 
+name: alert_tweeter
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Jonathan D. Simms
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-05-09 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: twitter
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 2
+        - 0
+        - 2
+        version: 2.0.2
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: slop
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 2
+        - 4
+        - 2
+        version: 2.4.2
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 3
+        - 1
+        - 0
+        version: 3.1.0
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: i18n
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id004
+description: |
+  Nagios alerts go to twitter
+
+email: 
+- slyphon@gmail.com
+executables: 
+- tweet-alert
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- alert_tweeter.gemspec
+- bin/tweet-alert
+- lib/alert_tweeter.rb
+- lib/alert_tweeter/version.rb
+homepage: https://github.com/slyphon/alert_tweeter
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: alert_tweeter
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Nagios alerts go to twitter
+test_files: []
+