sensu-plugins-mysql 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2610f5b94c75984ca59d7f366360c2b323597ff2
+  data.tar.gz: 1311e95e8a892397cab04bd766a9050453384351
+SHA512:
+  metadata.gz: 18c32290b777d18ac8419d75d8cd4089477f2c7f631b68db07c1426a414db9d62df0dc45a5fc2c279b435fdadd87adea5f73f7497f3601a212c068b3260a4ec9
+  data.tar.gz: 7360349ac47a884f9ab3a5d9fd388f9d7a93e40082e437b94e0906352a9fc53a31232e263533e8c13fda4e8f71a22c7590791af358e730f8692f6c6d073f3518

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+#Change Log
+This project adheres to [Semantic Versioning](http://semver.org/).
+
+This CHANGELOG follows the format listed at [Keep A Changelog](http://keepachangelog.com/)
+
+## Unreleased][unreleased]
+
+## 0.0.1 - 2015-05-29
+
+### Added
+- initial release

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Sensu-Plugins
+
+MIT License
+
+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,41 @@
+## Sensu-Plugins-mysql
+
+[![Build Status](https://travis-ci.org/sensu-plugins/sensu-plugins-mysql.svg?branch=master)](https://travis-ci.org/sensu-plugins/sensu-plugins-mysql)
+[![Gem Version](https://badge.fury.io/rb/sensu-plugins-mysql.svg)](http://badge.fury.io/rb/sensu-plugins-mysql)
+[![Code Climate](https://codeclimate.com/github/sensu-plugins/sensu-plugins-mysql/badges/gpa.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-mysql)
+[![Test Coverage](https://codeclimate.com/github/sensu-plugins/sensu-plugins-mysql/badges/coverage.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-mysql)
+[![Dependency Status](https://gemnasium.com/sensu-plugins/sensu-plugins-mysql.svg)](https://gemnasium.com/sensu-plugins/sensu-plugins-mysql)
+[![Codeship Status for sensu-plugins/sensu-plugins-mysql](https://codeship.com/projects/266116c0-e896-0132-af9a-62885e5c211b/status?branch=master)](https://codeship.com/projects/82837)
+
+## Functionality
+
+## Files
+ * bin/check-cloudwatch-mysql-sensu.rb
+ * bin/check-mysql-alive.rb
+ * bin/check-mysql-connections.rb
+ * bin/check-mysql-disk.rb
+ * bin/check-mysql-innodb-lock.rb
+ * bin/metrics-mysql-graphite.rb
+ * bin/metrics-mysql.rb
+ * bin/mysql-metrics.sql
+
+## Usage
+
+**metrics-mysql**
+```
+{
+    "mysql":{
+        "hostname": "localhost",
+        "username": "sensu_user",
+        "password": "sensu_user_pass"
+    }
+}
+```
+
+## Installation
+
+[Installation and Setup](https://github.com/sensu-plugins/documentation/blob/master/user_docs/installation_instructions.md)
+
+
+## Notes
+

data/bin/check-cloudwatch-mysql-sensu.rb

@@ -0,0 +1,157 @@
+#! /usr/bin/env ruby
+#
+#   <script name>
+#
+# DESCRIPTION:
+#   what is this thing supposed to do, monitor?  How do alerts or
+#   alarms work?
+#
+# OUTPUT:
+#   plain text, metric data, etc
+#
+# PLATFORMS:
+#   Linux, Windows, BSD, Solaris, etc
+#
+# DEPENDENCIES:
+#   gem: sensu-plugin
+#   gem: aws
+#
+# USAGE:
+#   example commands
+#
+# NOTES:
+#   Does it behave differently on specific platforms, specific use cases, etc
+#
+# LICENSE:
+#   <your name>  <your email>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+# !/usr/bin/env ruby
+#
+# Amazon RDS cloudwatch sensu plugin
+# ===
+#
+# Dependencies
+# -----------
+# - http://docs.aws.amazon.com/AmazonRDS/latest/CommandLineReference/StartCLI.html
+#
+#
+# Authors: Micah Hoffmann <https://github.com/SeattleMicah> Kristopher Zentner <https://github.com/kaezi>
+#
+#
+# Released under the same terms as Sensu (the MIT license); see LICENSE
+# for details.
+
+require 'aws/cloud_watch'
+require 'optparse'
+require 'pp'
+
+aws_access_key_id = ''
+aws_secret_key = ''
+aws_region = ''
+aws_debug = false
+
+options = {}
+optparse = OptionParser.new do|opts|
+  opts.on('-h', '--help', '') do
+    puts opts
+    exit
+  end
+
+  opts.on('-H', '--host HOST', 'Hostname') do |host|
+    options[:host] = host
+  end
+
+  opts.on('-w', '--warn WARN', 'Warning threshold') do |warn|
+    options[:warn] = warn
+  end
+
+  opts.on('-c', '--crit CRIT', 'Critical threshold') do |crit|
+    options[:crit] = crit
+  end
+
+  opts.on('-s', '--stat STAT', 'Statistic') do|stat|
+    options[:stat] = stat
+  end
+
+  opts.on('-l', '--lessthan', 'Threshold is less than') do|lessthan|
+    options[:lessthan] = lessthan
+  end
+end
+begin
+  optparse.parse!
+  mandatory = [:warn, :crit, :stat, :host]                         # Enforce the presence of
+  missing = mandatory.select { |param| options[param].nil? }        # the -t and -f switches
+  unless missing.empty?                                            #
+    puts "Missing options: #{missing.join(', ')}"                  #
+    puts optparse                                                  #
+    exit                                                           #
+  end                                                              #
+rescue OptionParser::InvalidOption, OptionParser::MissingArgument  #
+  puts $ERROR_INFO.to_s                                                     # Friendly output when parsing fails
+  puts optparse                                                    #
+  exit                                                             #
+end
+
+AWS.config(access_key_id: aws_access_key_id,
+           secret_access_key: aws_secret_key,
+           region: aws_region,
+           http_wire_trace: aws_debug)
+
+metric = AWS::CloudWatch::Metric.new('AWS/RDS', "#{options[:stat]}",
+                                     dimensions: [
+                                       { name: 'DBInstanceIdentifier', value: "#{options[:host]}" }
+                                     ])
+stats = metric.statistics(
+  start_time: Time.now - 600,
+  end_time: Time.now,
+  statistics: ['Average'])
+latest = stats.first
+# puts "#{stats.metric.name}: #{latest[:average]} #{latest[:unit]}"
+# puts "#{options[:crit].to_f}"
+if latest.nil?
+  msg = "WARNING: #{options[:host]} is not returning data! Is it deleted? Slave dead? "
+  msg += 'It could possibly mean there is no data to return, but make sure host is alive!'
+  puts msg
+  exit 2
+end
+
+average = latest[:average]
+unit = latest[:unit]
+
+# Determine the unit for the average returned and convert if needed
+if unit == 'Bytes' && options[:stat] == 'FreeStorageSpace'
+  average = (latest[:average] / 1_073_741_824).round(0)
+  unit = 'GigaBytes'
+elsif unit == 'Bytes'
+  average = (latest[:average] / 1_048_576).round(0)
+  unit = 'MegaBytes'
+else
+  average = latest[:average]
+end
+
+# Depending on if the stat is less than or greater than use the -l option
+if options[:lessthan] == true
+  # Begin the check of the average and against the warn and crit parameters
+  if average.to_f < options[:crit].to_f
+    puts "CRITICAL: #{options[:host]} statistic #{options[:stat]} is at #{average} #{unit} which is below threshold #{options[:crit]} #{unit}"
+    exit 1
+  elsif average.to_f < options[:warn].to_f
+    puts "WARNING: #{options[:host]} statistic #{options[:stat]} is at #{average} #{unit} which is below threshold #{options[:warn]} #{unit}"
+    exit 2
+  else
+    puts "OK: #{options[:host]} statistic #{options[:stat]} is #{average} #{unit}"
+  end
+else
+  if average.to_f > options[:crit].to_f
+    puts "CRITICAL: #{options[:host]} statistic #{options[:stat]} is at #{average} #{unit} which is above threshold #{options[:crit]} #{unit}"
+    exit 1
+  elsif average.to_f > options[:warn].to_f
+    puts "WARNING: #{options[:host]} statistic #{options[:stat]} is at #{average} #{unit} which is above threshold #{options[:warn]} #{unit}"
+    exit 2
+  else
+    puts "OK: #{options[:host]} statistic #{options[:stat]} is #{average} #{unit}"
+  end
+end

data/bin/check-mysql-alive.rb

@@ -0,0 +1,92 @@
+# !/usr/bin/env ruby
+#
+# MySQL Alive Plugin
+# ===
+#
+# This plugin attempts to login to mysql with provided credentials.
+#
+# Copyright 2011 Joe Crim <josephcrim@gmail.com>
+# Updated by Lewis Preson 2012 to accept a database parameter
+# Updated by Oluwaseun Obajobi 2014 to accept ini argument
+#
+# Released under the same terms as Sensu (the MIT license); see LICENSE
+# for details.
+#
+# USING INI ARGUMENT
+# This was implemented to load mysql credentials without parsing the username/password.
+# The ini file should be readable by the sensu user/group.
+# Ref: http://eric.lubow.org/2009/ruby/parsing-ini-files-with-ruby/
+#
+#   EXAMPLE
+#     mysql-alive.rb -h db01 --ini '/etc/sensu/my.cnf'
+#
+#   MY.CNF INI FORMAT
+#   [client]
+#   user=sensu
+#   password="abcd1234"
+#
+
+require 'sensu-plugin/check/cli'
+require 'mysql'
+require 'inifile'
+
+class CheckMySQL < Sensu::Plugin::Check::CLI
+  option :user,
+         description: 'MySQL User',
+         short: '-u USER',
+         long: '--user USER'
+
+  option :password,
+         description: 'MySQL Password',
+         short: '-p PASS',
+         long: '--password PASS'
+
+  option :ini,
+         description: 'My.cnf ini file',
+         short: '-i',
+         long: '--ini VALUE'
+
+  option :hostname,
+         description: 'Hostname to login to',
+         short: '-h HOST',
+         long: '--hostname HOST'
+
+  option :database,
+         description: 'Database schema to connect to',
+         short: '-d DATABASE',
+         long: '--database DATABASE',
+         default: 'test'
+
+  option :port,
+         description: 'Port to connect to',
+         short: '-P PORT',
+         long: '--port PORT',
+         default: '3306'
+
+  option :socket,
+         description: 'Socket to use',
+         short: '-s SOCKET',
+         long: '--socket SOCKET'
+
+  def run
+    if config[:ini]
+      ini = IniFile.load(config[:ini])
+      section = ini['client']
+      db_user = section['user']
+      db_pass = section['password']
+    else
+      db_user = config[:user]
+      db_pass = config[:password]
+    end
+
+    begin
+      db = Mysql.real_connect(config[:hostname], db_user, db_pass, config[:database], config[:port].to_i, config[:socket])
+      info = db.get_server_info
+      ok "Server version: #{info}"
+    rescue Mysql::Error => e
+      critical "Error message: #{e.error}"
+    ensure
+      db.close if db
+    end
+  end
+end

data/bin/check-mysql-connections.rb

@@ -0,0 +1,91 @@
+# !/usr/bin/env ruby
+#
+# MySQL Health Plugin
+# ===
+#
+# This plugin counts the maximum connections your MySQL has reached and warns you according to specified limits
+#
+# Copyright 2012 Panagiotis Papadomitsos <pj@ezgr.net>
+#
+# Released under the same terms as Sensu (the MIT license); see LICENSE
+# for details.
+
+require 'sensu-plugin/check/cli'
+require 'mysql'
+
+class CheckMySQLHealth < Sensu::Plugin::Check::CLI
+  option :user,
+         description: 'MySQL User',
+         short: '-u USER',
+         long: '--user USER',
+         default: 'root'
+
+  option :password,
+         description: 'MySQL Password',
+         short: '-p PASS',
+         long: '--password PASS',
+         required: true
+
+  option :hostname,
+         description: 'Hostname to login to',
+         short: '-h HOST',
+         long: '--hostname HOST',
+         default: 'localhost'
+
+  option :port,
+         description: 'Port to connect to',
+         short: '-P PORT',
+         long: '--port PORT',
+         default: '3306'
+
+  option :socket,
+         description: 'Socket to use',
+         short: '-s SOCKET',
+         long: '--socket SOCKET'
+
+  option :maxwarn,
+         description: "Number of connections upon which we'll issue a warning",
+         short: '-w NUMBER',
+         long: '--warnnum NUMBER',
+         default: 100
+
+  option :maxcrit,
+         description: "Number of connections upon which we'll issue an alert",
+         short: '-c NUMBER',
+         long: '--critnum NUMBER',
+         default: 128
+
+  option :usepc,
+         description: 'Use percentage of defined max connections instead of absolute number',
+         short: '-a',
+         long: '--percentage',
+         default: false
+
+  def run
+    db = Mysql.real_connect(config[:hostname], config[:user], config[:password], config[:database], config[:port].to_i, config[:socket])
+    max_con = db
+              .query("SHOW VARIABLES LIKE 'max_connections'")
+              .fetch_hash
+              .fetch('Value')
+              .to_i
+    used_con = db
+               .query("SHOW GLOBAL STATUS LIKE 'Threads_connected'")
+               .fetch_hash
+               .fetch('Value')
+               .to_i
+    if config[:usepc]
+      pc = used_con.fdiv(max_con) * 100
+      critical "Max connections reached in MySQL: #{used_con} out of #{max_con}" if pc >= config[:maxcrit].to_i
+      warning "Max connections reached in MySQL: #{used_con} out of #{max_con}" if pc >= config[:maxwarn].to_i
+      ok "Max connections is under limit in MySQL: #{used_con} out of #{max_con}"
+    else
+      critical "Max connections reached in MySQL: #{used_con} out of #{max_con}" if used_con >= config[:maxcrit].to_i
+      warning "Max connections reached in MySQL: #{used_con} out of #{max_con}" if used_con >= config[:maxwarn].to_i
+      ok "Max connections is under limit in MySQL: #{used_con} out of #{max_con}"
+    end
+rescue Mysql::Error => e
+  critical "MySQL check failed: #{e.error}"
+ensure
+  db.close if db
+  end
+end

data/bin/check-mysql-disk.rb

@@ -0,0 +1,114 @@
+# !/usr/bin/env ruby
+#
+# MySQL Disk Usage Check
+# ===
+#
+# Copyright 2011 Sonian, Inc <chefs@sonian.net>
+#
+# Released under the same terms as Sensu (the MIT license); see LICENSE
+# for details.
+#
+# Check the size of the database and compare to crit and warn thresholds
+
+require 'sensu-plugin/check/cli'
+require 'mysql'
+
+class CheckMysqlDisk < Sensu::Plugin::Check::CLI
+  option :host,
+         short: '-h',
+         long: '--host=VALUE',
+         description: 'Database host'
+
+  option :user,
+         short: '-u',
+         long: '--username=VALUE',
+         description: 'Database username'
+
+  option :pass,
+         short: '-p',
+         long: '--password=VALUE',
+         description: 'Database password'
+
+  option :size,
+         short: '-s',
+         long: '--size=VALUE',
+         description: 'Database size'
+
+  option :warn,
+         short: '-w',
+         long: '--warning=VALUE',
+         description: 'Warning threshold',
+         default: '85'
+
+  option :crit,
+         short: '-c',
+         long: '--critical=VALUE',
+         description: 'Critical threshold',
+         default: '95'
+
+  option :help,
+         short: '-h',
+         long: '--help',
+         description: 'Check RDS disk usage',
+         on: :tail,
+         boolean: true,
+         show_options: true,
+         exit: 0
+
+  def run
+    db_host = config[:host]
+    db_user = config[:user]
+    db_pass = config[:pass]
+    disk_size = config[:size].to_f
+    critical_usage = config[:crit].to_f
+    warning_usage = config[:warn].to_f
+
+    if [db_host, db_user, db_pass, disk_size].any?(&:nil?)
+      unknown 'Must specify host, user, password and size'
+    end
+
+    begin
+      total_size = 0.0
+      db = Mysql.new(db_host, db_user, db_pass)
+
+      results = db.query <<-EOSQL
+        SELECT table_schema,
+        count(*) TABLES,
+        concat(round(sum(table_rows)/1000000,2),'M') rows,
+        round(sum(data_length)/(1024*1024*1024),2) DATA,
+        round(sum(index_length)/(1024*1024*1024),2) idx,
+        round(sum(data_length+index_length)/(1024*1024*1024),2) total_size,
+        round(sum(index_length)/sum(data_length),2) idxfrac
+        FROM information_schema.TABLES group by table_schema
+      EOSQL
+
+      unless results.nil?
+        results.each_hash do |row|
+          # #YELLOW
+          total_size = total_size + row['total_size'].to_f # rubocop:disable Style/SelfAssignment
+        end
+      end
+
+      disk_use_percentage = total_size / disk_size * 100
+      diskstr = "DB size: #{total_size}, disk use: #{disk_use_percentage}%"
+
+      if disk_use_percentage > critical_usage
+        critical "Database size exceeds critical threshold: #{diskstr}"
+      elsif disk_use_percentage > warning_usage
+        warning "Database size exceeds warning threshold: #{diskstr}"
+      else
+        ok diskstr
+      end
+
+    rescue Mysql::Error => e
+      errstr = "Error code: #{e.errno} Error message: #{e.error}"
+      critical "#{errstr} SQLSTATE: #{e.sqlstate}" if e.respond_to?('sqlstate')
+
+    rescue => e
+      critical e
+
+    ensure
+      db.close if db
+    end
+  end
+end