resurrected_god 0.14.0

data/lib/god/contacts/email.rb

@@ -0,0 +1,130 @@
+# Send a notice to an email address.
+#
+# to_email        - The String email address to which the email will be sent.
+# to_name         - The String name corresponding to the recipient.
+# from_email      - The String email address from which the email will be sent.
+# from_name       - The String name corresponding to the sender.
+# delivery_method - The Symbol delivery method. [ :smtp | :sendmail ]
+#                   (default: :smtp).
+#
+# === SMTP Options (when delivery_method = :smtp) ===
+# server_host     - The String hostname of the SMTP server (default: localhost).
+# server_port     - The Integer port of the SMTP server (default: 25).
+# server_auth     - The Symbol authentication method. Possible values:
+#                   [ nil | :plain | :login | :cram_md5 ]
+#                   The default is nil, which means no authentication. To
+#                   enable authentication, pass the appropriate symbol and
+#                   then pass the appropriate SMTP Auth Options (below).
+#
+# === SMTP Auth Options (when server_auth != nil) ===
+# server_domain   - The String domain.
+# server_user     - The String username.
+# server_password - The String password.
+#
+# === Sendmail Options (when delivery_method = :sendmail) ===
+# sendmail_path   - The String path to the sendmail executable
+#                   (default: "/usr/sbin/sendmail").
+# sendmail_args   - The String args to send to sendmail (default "-i -t").
+
+require 'time'
+require 'net/smtp'
+
+module God
+  module Contacts
+
+    class Email < Contact
+      class << self
+        attr_accessor :to_email, :to_name, :from_email, :from_name,
+                      :delivery_method, :server_host, :server_port,
+                      :server_auth, :server_domain, :server_user,
+                      :server_password, :sendmail_path, :sendmail_args
+        attr_accessor :format
+      end
+
+      self.from_email = 'god@example.com'
+      self.from_name = 'God Process Monitoring'
+      self.delivery_method = :smtp
+      self.server_auth = nil
+      self.server_host = 'localhost'
+      self.server_port = 25
+      self.sendmail_path = '/usr/sbin/sendmail'
+      self.sendmail_args = '-i -t'
+
+      self.format = lambda do |name, from_email, from_name, to_email, to_name, message, time, priority, category, host|
+        <<-EOF
+From: #{from_name} <#{from_email}>
+To: #{to_name || name} <#{to_email}>
+Subject: [god] #{message}
+Date: #{time.httpdate}
+Message-Id: <#{rand(1000000000).to_s(36)}.#{$$}.#{from_email}>
+
+Message: #{message}
+Host: #{host}
+Priority: #{priority}
+Category: #{category}
+        EOF
+      end
+
+      attr_accessor :to_email, :to_name, :from_email, :from_name,
+                    :delivery_method, :server_host, :server_port,
+                    :server_auth, :server_domain, :server_user,
+                    :server_password, :sendmail_path, :sendmail_args
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'to_email' must be specified", self) unless arg(:to_email)
+        valid &= complain("Attribute 'delivery_method' must be one of [ :smtp | :sendmail ]", self) unless [:smtp, :sendmail].include?(arg(:delivery_method))
+        if arg(:delivery_method) == :smtp
+          valid &= complain("Attribute 'server_host' must be specified", self) unless arg(:server_host)
+          valid &= complain("Attribute 'server_port' must be specified", self) unless arg(:server_port)
+          if arg(:server_auth)
+            valid &= complain("Attribute 'server_domain' must be specified", self) unless arg(:server_domain)
+            valid &= complain("Attribute 'server_user' must be specified", self) unless arg(:server_user)
+            valid &= complain("Attribute 'server_password' must be specified", self) unless arg(:server_password)
+          end
+        end
+        valid
+      end
+
+      def notify(message, time, priority, category, host)
+        body = Email.format.call(self.name, arg(:from_email), arg(:from_name),
+                                 arg(:to_email), arg(:to_name), message, time,
+                                 priority, category, host)
+
+        case arg(:delivery_method)
+          when :smtp
+            notify_smtp(body)
+          when :sendmail
+            notify_sendmail(body)
+        end
+
+        self.info = "sent email to #{arg(:to_email)} via #{arg(:delivery_method).to_s}"
+      rescue Object => e
+        applog(nil, :info, "failed to send email to #{arg(:to_email)} via #{arg(:delivery_method).to_s}: #{e.message}")
+        applog(nil, :debug, e.backtrace.join("\n"))
+      end
+
+      def notify_smtp(mail)
+        args = [arg(:server_host), arg(:server_port)]
+        if arg(:server_auth)
+          args << arg(:server_domain)
+          args << arg(:server_user)
+          args << arg(:server_password)
+          args << arg(:server_auth)
+        end
+
+        Net::SMTP.start(*args) do |smtp|
+          smtp.send_message(mail, arg(:from_email), arg(:to_email))
+        end
+      end
+
+      def notify_sendmail(mail)
+        IO.popen("#{arg(:sendmail_path)} #{arg(:sendmail_args)}","w+") do |sm|
+          sm.print(mail.gsub(/\r/, ''))
+          sm.flush
+        end
+      end
+    end
+
+  end
+end

data/lib/god/contacts/hipchat.rb

@@ -0,0 +1,117 @@
+# Send a notice to a Hipchat room (http://hipchat.com).
+#
+#  token     - The String token used for authentication.
+#  room      - The String room name to which the message should be sent.
+#  ssl       - A Boolean determining whether or not to use SSL
+#              (default: false).
+#  from      - The String representing who the message should be sent as.
+
+require 'net/http'
+require 'net/https'
+
+CONTACT_DEPS[:hipchat] = ['json']
+CONTACT_DEPS[:hipchat].each do |d|
+  require d
+end
+
+module Marshmallow
+  class Connection
+    def initialize(options)
+      raise "Required option :token not set." unless options[:token]
+      @options = options
+    end
+
+    def base_url
+      scheme = @options[:ssl] ? 'https' : 'http'
+      "#{scheme}://api.hipchat.com/v1/rooms"
+    end
+
+    def find_room_id_by_name(room_name)
+      url = URI.parse("#{base_url}/list?format=json&auth_token=#{@options[:token]}")
+      http = Net::HTTP.new(url.host, url.port)
+      http.use_ssl = true if @options[:ssl]
+
+      req = Net::HTTP::Get.new(url.request_uri)
+      req.set_content_type('application/json')
+
+      res = http.request(req)
+      case res
+        when Net::HTTPSuccess
+          rooms = JSON.parse(res.body)
+          room = rooms['rooms'].select { |x| x['name'] == room_name }
+          rooms.empty? ? nil : room.first['room_id'].to_i
+        else
+          raise res.error!
+      end
+    end
+
+    def speak(room, message)
+      room_id = find_room_id_by_name(room)
+      puts "in spark: room_id = #{room_id}"
+      raise "No such room: #{room}." unless room_id
+
+      escaped_message = URI.escape(message)
+
+      url = URI.parse("#{base_url}/message?message_format=text&format=json&auth_token=#{@options[:token]}&from=#{@options[:from]}&room_id=#{room}&message=#{escaped_message}")
+      
+      http = Net::HTTP.new(url.host, url.port)
+      http.use_ssl = true if @options[:ssl]
+
+      req = Net::HTTP::Post.new(url.request_uri)
+      req.set_content_type('application/json')
+      res = http.request(req)
+      case res
+        when Net::HTTPSuccess
+          true
+        else
+          raise res.error!
+      end
+    end
+  end
+end
+
+module God
+  module Contacts
+
+    class Hipchat < Contact
+      class << self
+        attr_accessor :token, :room, :ssl, :from
+        attr_accessor :format
+      end
+
+      self.ssl = false
+
+      self.format = lambda do |message, time, priority, category, host|
+        "[#{time.strftime('%H:%M:%S')}] #{host} - #{message}"
+      end
+
+      attr_accessor :token, :room, :ssl, :from
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'token' must be specified", self) unless arg(:token)
+        valid &= complain("Attribute 'room' must be specified", self) unless arg(:room)
+        valid &= complain("Attribute 'from' must be specified", self) unless arg(:from)
+        valid
+      end
+
+      def notify(message, time, priority, category, host)
+        body = Hipchat.format.call(message, time, priority, category, host)
+
+        conn = Marshmallow::Connection.new(
+          :token => arg(:token),
+          :ssl   => arg(:ssl),
+          :from  => arg(:from)
+        )
+
+        conn.speak(arg(:room), body)
+
+        self.info = "notified hipchat: #{arg(:room)}"
+      rescue Object => e
+        applog(nil, :info, "failed to notify hipchat: #{e.message}")
+        applog(nil, :debug, e.backtrace.join("\n"))
+      end
+    end
+
+  end
+end

data/lib/god/contacts/jabber.rb

@@ -0,0 +1,75 @@
+# Send a notice to a Jabber address.
+#
+# host     - The String hostname of the Jabber server.
+# port     - The Integer port of the Jabber server (default: 5222).
+# from_jid - The String Jabber ID of the sender.
+# password - The String password of the sender.
+# to_jid   - The String Jabber ID of the recipient.
+# subject  - The String subject of the message (default: "God Notification").
+
+CONTACT_DEPS[:jabber] = ['xmpp4r']
+CONTACT_DEPS[:jabber].each do |d|
+  require d
+end
+
+module God
+  module Contacts
+
+    class Jabber < Contact
+      class << self
+        attr_accessor :host, :port, :from_jid, :password, :to_jid, :subject
+        attr_accessor :format
+      end
+
+      self.port = 5222
+      self.subject = 'God Notification'
+
+      self.format = lambda do |message, time, priority, category, host|
+        text  = "Message: #{message}\n"
+        text += "Host: #{host}\n"         if host
+        text += "Priority: #{priority}\n" if priority
+        text += "Category: #{category}\n" if category
+        text
+      end
+
+      attr_accessor :host, :port, :from_jid, :password, :to_jid, :subject
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'host' must be specified", self) unless arg(:host)
+        valid &= complain("Attribute 'port' must be specified", self) unless arg(:port)
+        valid &= complain("Attribute 'from_jid' must be specified", self) unless arg(:from_jid)
+        valid &= complain("Attribute 'to_jid' must be specified", self) unless arg(:to_jid)
+        valid &= complain("Attribute 'password' must be specified", self) unless arg(:password)
+        valid
+      end
+
+      def notify(message, time, priority, category, host)
+        body = Jabber.format.call(message, time, priority, category, host)
+
+        message = ::Jabber::Message.new(arg(:to_jid), body)
+        message.set_type(:normal)
+        message.set_id('1')
+        message.set_subject(arg(:subject))
+
+        jabber_id = ::Jabber::JID.new("#{arg(:from_jid)}/God")
+
+        client = ::Jabber::Client.new(jabber_id)
+        client.connect(arg(:host), arg(:port))
+        client.auth(arg(:password))
+        client.send(message)
+        client.close
+
+        self.info = "sent jabber message to #{self.to_jid}"
+      rescue Object => e
+        if e.respond_to?(:message)
+          applog(nil, :info, "failed to send jabber message to #{arg(:to_jid)}: #{e.message}")
+        else
+          applog(nil, :info, "failed to send jabber message to #{arg(:to_jid)}: #{e.class}")
+        end
+        applog(nil, :debug, e.backtrace.join("\n"))
+      end
+
+    end
+  end
+end

data/lib/god/contacts/prowl.rb

@@ -0,0 +1,57 @@
+# Send a notice to Prowl (http://prowl.weks.net/).
+#
+# apikey - The String API key.
+
+CONTACT_DEPS[:prowl] = ['prowly']
+CONTACT_DEPS[:prowl].each do |d|
+  require d
+end
+
+module God
+  module Contacts
+    class Prowl < Contact
+
+      class << self
+        attr_accessor :apikey
+      end
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'apikey' must be specified", self) if self.apikey.nil?
+        valid
+      end
+
+      attr_accessor :apikey
+
+      def notify(message, time, priority, category, host)
+        result = Prowly.notify do |n|
+          n.apikey      = arg(:apikey)
+          n.priority    = map_priority(priority.to_i)
+          n.application = category || "God"
+          n.event       = "on " + host.to_s
+          n.description = message.to_s + " at " + time.to_s
+        end
+
+        if result.succeeded?
+          self.info = "sent prowl notification to #{self.name}"
+        else
+          self.info = "failed to send prowl notification to #{self.name}: #{result.message}"
+        end
+      rescue Object => e
+        applog(nil, :info, "failed to send prowl notification to #{self.name}: #{e.message}")
+        applog(nil, :debug, e.backtrace.join("\n"))
+      end
+
+      def map_priority(priority)
+        case priority
+           when 1 then Prowly::Notification::Priority::EMERGENCY
+           when 2 then Prowly::Notification::Priority::HIGH
+           when 3 then Prowly::Notification::Priority::NORMAL
+           when 4 then Prowly::Notification::Priority::MODERATE
+           when 5 then Prowly::Notification::Priority::VERY_LOW
+           else Prowly::Notification::Priority::NORMAL
+        end
+      end
+    end
+  end
+end

data/lib/god/contacts/scout.rb

@@ -0,0 +1,55 @@
+# Send a notice to Scout (http://scoutapp.com/).
+#
+# client_key - The String client key.
+# plugin_id  - The String plugin id.
+
+require 'net/http'
+require 'uri'
+
+module God
+  module Contacts
+
+    class Scout < Contact
+      class << self
+        attr_accessor :client_key, :plugin_id
+        attr_accessor :format
+      end
+
+      self.format = lambda do |message, priority, category, host|
+        text  = "Message: #{message}\n"
+        text += "Host: #{host}\n"         if host
+        text += "Priority: #{priority}\n" if priority
+        text += "Category: #{category}\n" if category
+        return text
+      end
+
+      attr_accessor :client_key, :plugin_id
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'client_key' must be specified", self) unless arg(:client_key)
+        valid &= complain("Attribute 'plugin_id' must be specified", self) unless arg(:plugin_id)
+        valid
+      end
+
+      def notify(message, time, priority, category, host)
+        data = {
+          :client_key => arg(:client_key),
+          :plugin_id => arg(:plugin_id),
+          :format => 'xml',
+          'alert[subject]' => message,
+          'alert[body]' => Scout.format.call(message, priority, category, host)
+        }
+
+        uri = URI.parse('http://scoutapp.com/alerts/create')
+        Net::HTTP.post_form(uri, data)
+
+        self.info = "sent scout alert to plugin ##{plugin_id}"
+      rescue => e
+        applog(nil, :info, "failed to send scout alert to plugin ##{plugin_id}: #{e.message}")
+        applog(nil, :debug, e.backtrace.join("\n"))
+      end
+    end
+
+  end
+end

data/lib/god/contacts/sensu.rb

@@ -0,0 +1,59 @@
+# ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+# Send a notice to a SENSU client socket, port 3030 on 'localhost' only.
+# ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+# [mandatory]
+# check_name    - a unique check name
+#
+# [optional]
+# status_code   - status codes used are 0 for OK, 1 for WARNING, 2 for CRITICAL, and 3 or greater to indicate UNKNOWN or CUSTOM.
+# handler       - default handler
+#
+
+CONTACT_DEPS[:sensu] = ['json']
+CONTACT_DEPS[:sensu].each do |d|
+  require d
+end
+
+module God
+  module Contacts
+
+    class Sensu < Contact
+      class << self
+        attr_accessor :check_name, :status_code, :handler, :host, :port
+      end
+
+      self.status_code = 2
+      self.handler = 'default'
+      self.host = 'localhost'
+      self.port = 3030
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'check_name' must be specified", self) unless arg(:check_name)
+        valid
+      end
+
+      attr_accessor :check_name, :status_code, :handler, :host, :port
+
+      def sensu_client_socket(msg)
+        u = UDPSocket.new
+        u.send(msg + "\n", 0, arg(:host).nil? ? self.host : arg(:host), arg(:port).nil? ? self.port : arg(:port))
+        u.close
+      end
+
+      def notify(message, time, priority, category, host)
+        data = {
+          :category => category,
+          :message => message,
+          :priority => priority,
+          :host => host,
+          :time => time,
+        }
+        parcel = { 'name' => arg(:check_name), 'status' => arg(:status_code).nil? ? self.status_code : arg(:status_code), 'output' => data.to_json, 'handler' => arg(:handler).empty? ? self.handler : arg(:handler), 'executed' => Time.now.to_i }
+        sensu_client_socket parcel.to_json
+        self.info = "notified sensu: #{arg(:check_name)}"
+      end
+    end
+  end
+end
+

data/lib/god/contacts/slack.rb

@@ -0,0 +1,98 @@
+# Send a message to a Slack channel
+#
+# account        - The name of your Slack account (visible in URL, e.g. foo.slack.com)
+# token          - The token of the webhook created in Slack
+# channel        - The name of the channel to send the message to, prefixed with #
+# notify_channel - Whether to send an "@channel" in the message, to alert everyone in the channel
+# format         - An optional format string to change how the alert is displayed
+
+require 'net/http'
+require 'uri'
+
+CONTACT_DEPS[:slack] = ['json']
+CONTACT_DEPS[:slack].each do |d|
+  require d
+end
+
+module God
+  module Contacts
+
+    class Slack < Contact
+      class << self
+        attr_accessor :url, :channel, :notify_channel, :format, :username, :emoji
+      end
+
+      self.channel        = "#general"
+      self.notify_channel = false
+      self.format         = "%{priority} alert on %{host}: %{message} (%{category}, %{time})"
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'url' must be specified", self) unless arg(:url)
+        valid
+      end
+
+      attr_accessor :url, :channel, :notify_channel, :format, :username, :emoji
+
+      def text(data)
+        text = ""
+        text << "<!channel> " if arg(:notify_channel)
+
+        if RUBY_VERSION =~ /^1\.8/
+          text << arg(:format).gsub(/%\{(\w+)\}/) do |match|
+            data[$1.to_sym]
+          end
+        else
+          text << arg(:format) % data
+        end
+
+        text
+      end
+
+      def notify(message, time, priority, category, host)
+        text = text({
+          :message => message,
+          :time => time,
+          :priority => priority,
+          :category => category,
+          :host => host
+        })
+
+        request(text)
+      end
+
+      def api_url
+        URI.parse arg(:url)
+      end
+
+      def request(text)
+        http = Net::HTTP.new(api_url.host, api_url.port)
+        http.use_ssl = true
+
+        req = Net::HTTP::Post.new(api_url.request_uri)
+        req.body = {
+          :link_names => 1,
+          :text => text,
+          :channel => arg(:channel)
+        }.tap { |payload|
+          payload[:username] = arg(:username) if arg(:username)
+          payload[:icon_emoji] = arg(:emoji) if arg(:emoji)
+        }.to_json
+
+        res = http.request(req)
+
+        case res
+          when Net::HTTPSuccess
+            self.info = "successfully notified slack on channel #{arg(:channel)}"
+          else
+            self.info = "failed to send webhook to #{arg(:url)}: #{res.error!}"
+        end
+      rescue Object => e
+        applog(nil, :info, "failed to send webhook to #{arg(:url)}: #{e.message}")
+        applog(nil, :debug, e.backtrace.join("\n"))
+      end
+
+    end
+
+  end
+end

data/lib/god/contacts/statsd.rb

@@ -0,0 +1,46 @@
+# Send a notice to statsd
+#
+# host - statsd host
+# port - statsd port (optional)
+
+require 'statsd-ruby'
+
+module God
+  module Contacts
+
+    class Statsd < Contact
+      class << self
+        attr_accessor :host, :port
+      end
+
+      attr_accessor :host, :port
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'statsd_host' must be specified", self) unless arg(:host)
+        valid
+      end
+
+      def notify(message, time, priority, category, hostname)
+        statsd = ::Statsd.new host, (port ? port.to_i : 8125) # 8125 is the default statsd port
+
+        hostname.gsub! /\./, '_'
+        app = message.gsub /([^\s]*).*/, '\1'
+
+        [
+            'cpu out of bounds',
+            'memory out of bounds',
+            'process is flapping'
+        ].each do |event_type|
+          statsd.increment "god.#{event_type.gsub(/\s/, '_')}.#{hostname}.#{app}" if message.include? event_type
+        end
+
+        self.info = 'sent statsd alert'
+      rescue => e
+        applog(nil, :info, "failed to send statsd alert: #{e.message}")
+        applog(nil, :debug, e.backtrace.join("\n"))
+      end
+    end
+
+  end
+end

data/lib/god/contacts/twitter.rb

@@ -0,0 +1,51 @@
+# Send a notice to a Twitter account (http://twitter.com/).
+#
+# consumer_token  - The String OAuth consumer token (defaults to God's
+#                   existing consumer token).
+# consumer_secret - The String OAuth consumer secret (defaults to God's
+#                   existing consumer secret).
+# access_token    - The String OAuth access token.
+# access_secret   - The String OAuth access secret.
+
+CONTACT_DEPS[:twitter] = ['twitter']
+CONTACT_DEPS[:twitter].each do |d|
+  require d
+end
+
+module God
+  module Contacts
+    class Twitter < Contact
+      class << self
+        attr_accessor :consumer_token, :consumer_secret,
+                      :access_token, :access_secret
+      end
+
+      self.consumer_token = 'gOhjax6s0L3mLeaTtBWPw'
+      self.consumer_secret = 'yz4gpAVXJHKxvsGK85tEyzQJ7o2FEy27H1KEWL75jfA'
+
+      def valid?
+        valid = true
+        valid &= complain("Attribute 'consumer_token' must be specified", self) unless arg(:consumer_token)
+        valid &= complain("Attribute 'consumer_secret' must be specified", self) unless arg(:consumer_secret)
+        valid &= complain("Attribute 'access_token' must be specified", self) unless arg(:access_token)
+        valid &= complain("Attribute 'access_secret' must be specified", self) unless arg(:access_secret)
+        valid
+      end
+
+      attr_accessor :consumer_token, :consumer_secret,
+                    :access_token, :access_secret
+
+      def notify(message, time, priority, category, host)
+        oauth = ::Twitter::OAuth.new(arg(:consumer_token), arg(:consumer_secret))
+        oauth.authorize_from_access(arg(:access_token), arg(:access_secret))
+
+        ::Twitter::Base.new(oauth).update(message)
+
+        self.info = "sent twitter update"
+      rescue => e
+        applog(nil, :info, "failed to send twitter update: #{e.message}")
+        applog(nil, :debug, e.backtrace.join("\n"))
+      end
+    end
+  end
+end