sensu-plugins-oracle 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e05bc65c5bf93831644ccdebae43ecc27f7a35ab
+  data.tar.gz: 853e25216e18f24f0ec94d2c357f805dcfc1e228
+SHA512:
+  metadata.gz: 95dbd868e884e2aa3692de4a8d8d37320f946c5b2b2fd62fd57745307653ba555d3d5a8dc082111a3182e9c74193c7cc5dd505440575cb8f2f5499451c8682a2
+  data.tar.gz: 6e26c529fb09bb2c330d09155011b393e7327b12b4de2d2844d001dfc2ad25cd807490f886fbe77920ad0ed9b721bd7be4032e9c23546e989029bac770ff939a

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1 - 2016-08-03
+### Added
+- initial release based on sensu-plugins-postgres (https://github.com/sensu-plugins/sensu-plugins-postgres)

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 thomis
+
+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,34 @@
+
+[![Code Climate](https://codeclimate.com/github/thomis/sensu-plugins-oracle/badges/gpa.svg)](https://codeclimate.com/github/thomis/sensu-plugins-oracle)
+[![Dependency Status](https://gemnasium.com/badges/github.com/thomis/sensu-plugins-oracle.svg)](https://gemnasium.com/github.com/thomis/sensu-plugins-oracle)
+
+# sensu-plugins-oracle
+
+This sensu plugin provides native Oracle instrumentation.
+
+## Files
+ * bin/check-oracle-alive.rb
+
+## Usage
+
+  ```
+  check-oracle-alive.rb -u scott -p tiger -d hr
+
+  check-oracle-alive.rb -u scott -p tiger -d ht -T 30
+  ```
+
+  ```
+  check-oracle-alive.rb -f connections.csv
+
+  > cat connections.csv
+  # production connection
+  example_connection_1,scott/tiger@hr
+
+  # test connection
+  example_connection_2,scott/tiger@hr_test
+
+  ```
+
+## Installation
+
+[Installation and Setup](http://sensu-plugins.io/docs/installation_instructions.html)

data/bin/check-oracle-alive.rb

@@ -0,0 +1,123 @@
+#! /usr/bin/env ruby
+#
+#   check-oracle-alive
+#
+# DESCRIPTION:
+#
+#   This plugin attempts to login to oracle with provided credentials.
+#
+# OUTPUT:
+#   plain text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: sensu-plugin
+#   gem: ruby-oci8
+#
+# USAGE:
+#   ./check-oracle-alive.rb -u db_user -p db_pass -h db_host -d db
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright (c) 2016 Thomas Steiner
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugins-oracle'
+require 'sensu-plugin/check/cli'
+
+class CheckOracle < Sensu::Plugin::Check::CLI
+  option :username,
+         description: 'Oracle Username',
+         short: '-u USERNAME',
+         long: '--username USERNAME'
+
+  option :password,
+         description: 'Oracle Password',
+         short: '-p PASSWORD',
+         long: '--password PASSWORD'
+
+  option :database,
+         description: 'Database schema to connect to',
+         short: '-d DATABASE',
+         long: '--database DATABASE'
+
+  option :privilege,
+         description: 'Connect to Oracle database by optional priviledge (SYSDBA, SYSOPER, SYSASM,  , SYSDG or SYSKM)',
+         short: '-P PRIVILEGE',
+         long: '--privilege PRIVILEGE'
+
+  option :timeout,
+         description: 'Connection timeout (seconds)',
+         short: '-T TIMEOUT',
+         long: '--timeout TIMEOUT'
+
+  option :file,
+         description: 'File with connection strings to check',
+         short: '-f FILE',
+         long: '--file FILE'
+
+  def run
+    # handle OCI8 properties
+    OCI8.properties[:connect_timeout] = config[:timeout].to_i if config[:timeout]
+
+    if config[:file]
+      handle_connections_from_file
+    else
+      handle_connection
+    end
+  end
+
+  private
+
+  def handle_connections_from_file
+    sessions = ::SensuPluginsOracle::Session.parse_from_file(config[:file])
+
+    sessions_total = sessions.size
+    sessions_alive = 0
+
+    thread_group = ThreadGroup.new
+    queue = Queue.new
+    mutex = Mutex.new
+
+    sessions.each do |session|
+      thread_group.add Thread.new {
+        if session.alive?
+          mutex.synchronize do
+            sessions_alive += 1
+          end
+        else
+          queue << session.error_message
+        end
+      }
+    end
+    thread_group.list.map(&:join)
+    sessions_critical = queue.size.times.map { queue.pop }
+
+    if sessions_total == sessions_alive
+      ok "All are alive (#{sessions_alive}/#{sessions_total})"
+    else
+      critical ["#{sessions_alive}/#{sessions_total} are alive", sessions_critical].flatten.join("\n - ")
+    end
+  rescue => e
+    unknown e.to_s
+  end
+
+  def handle_connection
+    session = SensuPluginsOracle::Session.new(
+      username: config[:username],
+      password: config[:password],
+      database: config[:database],
+      privilege: config[:privilege])
+
+    if session.alive?
+      ok "Server version: #{session.server_version}"
+    else
+      critical session.error_message
+    end
+  end
+end

data/lib/sensu-plugins-oracle.rb

@@ -0,0 +1,4 @@
+require 'sensu-plugins-oracle/version'
+require 'sensu-plugins-oracle/session'
+
+require 'oci8'

data/lib/sensu-plugins-oracle/session.rb

@@ -0,0 +1,54 @@
+module SensuPluginsOracle
+  class Session
+
+    attr_reader :name, :error_message
+    attr_reader :connect_string
+    attr_reader :username, :password, :database, :priviledge
+
+    attr_reader :server_version
+
+    PRIVILEDGES = [:SYSDBA, :SYSOPER, :SYSASM, :SYSBACKUP, :SYSDG, :SYSKM]
+
+    def initialize(args)
+      @name = args[:name]
+      @error_message = nil
+
+      @connect_string = args[:connect_string]
+
+      @username = args[:username]
+      @password = args[:password]
+      @database = args[:database]
+      @priviledge = args[:priviledge].upcase.to_sym if args[:priviledge] && PRIVILEDGES.include?(args[:priviledge].upcase.to_sym)
+    end
+
+    def self.parse_from_file(file)
+      sessions = []
+
+      File.open(file) do |input|
+        input.each_line do |line|
+          line.strip!
+          next if line.size == 0 || line =~ /^#/
+          a = line.split(/:|,|;/)
+          sessions << Session.new(name: a[0], connect_string: a[1])
+        end
+      end
+
+      return sessions
+    end
+
+    def alive?
+      connection = OCI8.new(@connect_string) if @connect_string
+      connection = OCI8.new(@username, @password, @database) if @username
+
+      @server_version = connection.oracle_server_version
+
+      true
+    rescue OCIError => e
+      @error_message = [@name, e.message.split("\n").first].compact.join(": ")
+      false
+    ensure
+      connection.logoff if connection
+    end
+
+  end
+end

data/lib/sensu-plugins-oracle/version.rb

@@ -0,0 +1,9 @@
+module SensuPluginsOracle
+  module Version
+    MAJOR = 0
+    MINOR = 1
+    PATCH = 0
+
+    VER_STRING = [MAJOR, MINOR, PATCH].compact.join('.')
+  end
+end

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: sensu-plugins-oracle
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Sensu-Plugins and contributors
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-09-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sensu-plugin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: ruby-oci8
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.2'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: |-
+  This plugin provides native Oracle
+                                instrumentation.
+email: "<thomas.steiner@ikey.ch>"
+executables:
+- check-oracle-alive.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/check-oracle-alive.rb
+- lib/sensu-plugins-oracle.rb
+- lib/sensu-plugins-oracle/session.rb
+- lib/sensu-plugins-oracle/version.rb
+homepage: https://github.com/thomis/sensu-plugins-oracle
+licenses:
+- MIT
+metadata:
+  maintainer: "@tas50"
+  development_status: active
+  production_status: unstable - testing recommended
+  release_draft: 'false'
+  release_prerelease: 'false'
+post_install_message: You can use the embedded Ruby by setting EMBEDDED_RUBY=true
+  in /etc/default/sensu
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Sensu plugins for oracle
+test_files: []