sensu-plugins-mysql-boutetnico 1.0.0

data/bin/check-mysql-innodb-lock.rb

@@ -0,0 +1,148 @@
+#!/usr/bin/env ruby
+#
+# MySQL InnoDB Lock Check Plugin
+# ===
+#
+# This plugin checks InnoDB locks.
+#
+# Copyright 2014 Hiroaki Sano <hiroaki.sano.9stories@gmail.com>
+#
+# Released under the same terms as Sensu (the MIT license); see LICENSE
+# for details.
+
+require 'sensu-plugin/check/cli'
+require 'mysql'
+require 'inifile'
+
+class CheckMySQLInnoDBLock < 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'
+
+  option :ini,
+         description: 'My.cnf ini file',
+         short: '-i',
+         long: '--ini VALUE'
+
+  option :ini_section,
+         description: 'Section in my.cnf ini file',
+         long: '--ini-section VALUE',
+         default: 'client'
+
+  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 :warn,
+         description: 'Warning threshold',
+         short: '-w SECONDS',
+         long: '--warning SECONDS',
+         default: 5
+
+  option :crit,
+         description: 'Critical threshold',
+         short: '-c SECONDS',
+         long: '--critical SECONDS',
+         default: 10
+
+  def run
+    if config[:ini]
+      ini = IniFile.load(config[:ini])
+      section = ini[config[:ini_section]]
+      db_user = section['user']
+      db_pass = section['password']
+    else
+      db_user = config[:user]
+      db_pass = config[:password]
+    end
+    db = Mysql.new(config[:hostname], db_user, db_pass, config[:database], config[:port].to_i, config[:socket])
+
+    warn = config[:warn].to_i
+    crit = config[:crit].to_i
+
+    res = db.query <<-EQSQL
+      select
+        t_b.trx_mysql_thread_id blocking_id,
+        t_w.trx_mysql_thread_id requesting_id,
+        p_b.HOST blocking_host,
+        p_w.HOST requesting_host,
+        l.lock_table lock_table,
+        l.lock_index lock_index,
+        l.lock_mode lock_mode,
+        p_w.TIME seconds,
+        p_b.INFO blocking_info,
+        p_w.INFO requesting_info
+      from
+        information_schema.INNODB_LOCK_WAITS w,
+        information_schema.INNODB_LOCKS l,
+        information_schema.INNODB_TRX t_b,
+        information_schema.INNODB_TRX t_w,
+        information_schema.PROCESSLIST p_b,
+        information_schema.PROCESSLIST p_w
+      where
+          w.blocking_lock_id = l.lock_id
+        and
+          w.blocking_trx_id = t_b.trx_id
+        and
+          w.requesting_trx_id = t_w.trx_id
+        and
+          t_b.trx_mysql_thread_id = p_b.ID
+        and
+          t_w.trx_mysql_thread_id = p_w.ID
+        and
+          p_w.TIME > #{warn}
+      order by
+        requesting_id,blocking_id
+    EQSQL
+
+    lock_info = []
+    is_crit = false
+    res.each_hash do |row|
+      h = {}
+      is_crit = true if row['seconds'].to_i > crit
+      h['blocking_id'] = row['blocking_id']
+      h['requesting_id'] = row['requesting_id']
+      h['blocking_host'] = row['blocking_host']
+      h['requesting_host'] = row['requesting_host']
+      h['lock_table'] = row['lock_table']
+      h['lock_index'] = row['lock_index']
+      h['lock_mode'] = row['lock_mode']
+      h['seconds'] = row['seconds']
+      h['blocking_info'] = row['blocking_info']
+      h['requesting_info'] = row['requesting_info']
+      lock_info.push(h)
+    end
+
+    if lock_info.length == 0 # rubocop:disable Style/ZeroLengthPredicate
+      ok
+    elsif is_crit == false
+      warning "Detected Locks #{lock_info}"
+    else
+      critical "Detected Locks #{lock_info}"
+    end
+  rescue Mysql::Error => e
+    critical "MySQL check failed: #{e.error}"
+  ensure
+    db.close if db
+  end
+end

data/bin/check-mysql-msr-replication-status.rb

@@ -0,0 +1,157 @@
+#!/usr/bin/env ruby
+#
+# MySQL Multi-source Replication Status
+# ===
+#
+#
+#   EXAMPLE
+#     check-mysql-msr-replication-status.rb -h db01 --ini '/etc/sensu/my.cnf'
+#     check-mysql-msr-replication-status.rb -h db01 --ini '/etc/sensu/my.cnf' --ini-section customsection
+#
+#   MY.CNF INI FORMAT
+#   [client]
+#   user=sensu
+#   password="abcd1234"
+#
+#   [customsection]
+#   user=user
+#   password="password"
+#
+
+require 'sensu-plugin/check/cli'
+require 'mysql'
+require 'inifile'
+
+class CheckMysqlMSRReplicationStatus < Sensu::Plugin::Check::CLI
+  option :host,
+         short: '-h',
+         long: '--host VALUE',
+         description: 'Database host'
+
+  option :port,
+         short: '-P',
+         long: '--port VALUE',
+         description: 'Database port',
+         default: 3306,
+         proc: proc(&:to_i)
+
+  option :socket,
+         short: '-s SOCKET',
+         long: '--socket SOCKET',
+         description: 'Socket to use'
+
+  option :user,
+         short: '-u',
+         long: '--username VALUE',
+         description: 'Database username'
+
+  option :pass,
+         short: '-p',
+         long: '--password VALUE',
+         description: 'Database password'
+
+  option :ini,
+         short: '-i',
+         long: '--ini VALUE',
+         description: 'My.cnf ini file'
+
+  option :ini_section,
+         description: 'Section in my.cnf ini file',
+         long: '--ini-section VALUE',
+         default: 'client'
+
+  option :warn,
+         short: '-w',
+         long: '--warning VALUE',
+         description: 'Warning threshold for replication lag',
+         default: 900,
+         proc: proc(&:to_i)
+
+  option :crit,
+         short: '-c',
+         long: '--critical=VALUE',
+         description: 'Critical threshold for replication lag',
+         default: 1800,
+         proc: proc(&:to_i)
+
+  def set_status(io_thread_status, sql_thread_status, seconds_behind_master)
+    if io_thread_status == 'No' || sql_thread_status == 'No' || seconds_behind_master > config[:crit]
+      2
+    elsif seconds_behind_master > config[:warn] && seconds_behind_master <= config[:crit]
+      1
+    else
+      0
+    end
+  end
+
+  def run
+    if config[:ini]
+      ini = IniFile.load(config[:ini])
+      section = ini[config[:ini_section]]
+      db_user = section['user']
+      db_pass = section['password']
+    else
+      db_user = config[:user]
+      db_pass = config[:pass]
+    end
+    db_host = config[:host]
+
+    if [db_host, db_user, db_pass].any?(&:nil?)
+      unknown 'Must specify host, user, password'
+    end
+
+    begin
+      ok_statuses = []
+      warn_statuses = []
+      crit_statuses = []
+      output = []
+
+      db = Mysql.new(db_host, db_user, db_pass, nil, config[:port], config[:socket])
+      channels = db.query('SELECT channel_name FROM performance_schema.replication_connection_status')
+
+      channels.num_rows.times do
+        channel = channels.fetch_hash
+        results = db.query("SHOW SLAVE STATUS FOR CHANNEL \'#{channel['channel_name']}\'")
+        results.each_hash do |row|
+          io_thread_status = row['Slave_IO_Running']
+          sql_thread_status = row['Slave_SQL_Running']
+          seconds_behind_master = row['Seconds_Behind_Master'].to_i
+          status = set_status
+          message = "#{channel['channel_name']} STATES:"
+          message += " Slave_IO_Running=#{io_thread_status}"
+          message += ", Slave_SQL_Running=#{sql_thread_status}"
+          message += ", Seconds_Behind_Master=#{seconds_behind_master}"
+
+          if status == 0
+            ok_statuses << message
+          elsif status == 1
+            warn_statuses << message
+          elsif status == 2
+            crit_statuses << message
+          else
+            puts 'Undefined status.'
+          end
+        end
+      end
+      output << crit_statuses unless crit_statuses.empty?
+      output << warn_statuses unless warn_statuses.empty?
+      output << ok_statuses unless ok_statuses.empty?
+
+      if !crit_statuses.empty?
+        critical output
+      elsif !warn_statuses.empty?
+        warning output
+      else
+        ok output
+      end
+    rescue Mysql::Error => e
+      errstr = "Error code: #{e.errno} Error message: #{e.error}"
+      errstr += "SQLSTATE: #{e.sqlstate}" if e.respond_to?('sqlstate')
+      critical errstr
+    rescue StandardError => e
+      critical "unhandled exception: #{e}"
+    ensure
+      db.close if db
+    end
+  end
+end

data/bin/check-mysql-query-result-count.rb

@@ -0,0 +1,110 @@
+#!/usr/bin/env ruby
+#
+# MySQL Query Result Count Check
+#
+# Checks the length of a result set from a MySQL query.
+#
+# Copyright 2017 Andrew Thal <athal7@me.com>
+#
+# Released under the same terms as Sensu (the MIT license); see LICENSE
+# for details.
+
+require 'sensu-plugin/check/cli'
+require 'mysql'
+require 'inifile'
+
+class MysqlQueryCountCheck < Sensu::Plugin::Check::CLI
+  option :host,
+         short: '-h HOST',
+         long: '--host HOST',
+         description: 'MySQL Host to connect to',
+         required: true
+
+  option :port,
+         short: '-P PORT',
+         long: '--port PORT',
+         description: 'MySQL Port to connect to',
+         proc: proc(&:to_i),
+         default: 3306
+
+  option :username,
+         short: '-u USERNAME',
+         long: '--user USERNAME',
+         description: 'MySQL Username'
+
+  option :password,
+         short: '-p PASSWORD',
+         long: '--pass PASSWORD',
+         description: 'MySQL password',
+         default: ''
+
+  option :database,
+         short: '-d DATABASE',
+         long: '--database DATABASE',
+         description: 'MySQL database',
+         required: true
+
+  option :ini,
+         short: '-i',
+         long: '--ini VALUE',
+         description: 'My.cnf ini file'
+
+  option :ini_section,
+         description: 'Section in my.cnf ini file',
+         long: '--ini-section VALUE',
+         default: 'client'
+
+  option :socket,
+         short: '-S SOCKET',
+         long: '--socket SOCKET',
+         description: 'MySQL Unix socket to connect to'
+
+  option :warn,
+         short: '-w COUNT',
+         long: '--warning COUNT',
+         description: 'COUNT warning threshold for number of items returned by the query',
+         proc: proc(&:to_i),
+         required: true
+
+  option :crit,
+         short: '-c COUNT',
+         long: '--critical COUNT',
+         description: 'COUNT critical threshold for number of items returned by the query',
+         proc: proc(&:to_i),
+         required: true
+
+  option :query,
+         short: '-q QUERY',
+         long: '--query QUERY',
+         description: 'Query to execute',
+         required: true
+
+  def run
+    if config[:ini]
+      ini = IniFile.load(config[:ini])
+      section = ini[config[:ini_section]]
+      db_user = section['user']
+      db_pass = section['password']
+    else
+      db_user = config[:username]
+      db_pass = config[:password]
+    end
+    db = Mysql.real_connect(config[:host], db_user, db_pass, config[:database], config[:port].to_i, config[:socket])
+    length = db.query(config[:query]).count
+
+    if length >= config[:crit]
+      critical "Result count is above the CRITICAL limit: #{length} length / #{config[:crit]} limit"
+    elsif length >= config[:warn]
+      warning "Result count is above the WARNING limit: #{length} length / #{config[:warn]} limit"
+    else
+      ok 'Result count length is below thresholds'
+    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 StandardError => e
+    critical e
+  ensure
+    db.close if db
+  end
+end

data/bin/check-mysql-replication-status.rb

@@ -0,0 +1,185 @@
+#!/usr/bin/env ruby
+#
+# MySQL Replication Status (modded from disk)
+# ===
+#
+# Copyright 2011 Sonian, Inc <chefs@sonian.net>
+# Updated by Oluwaseun Obajobi 2014 to accept ini argument
+# Updated by Nicola Strappazzon 2016 to implement Multi Source Replication
+#
+# 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'
+#     mysql-alive.rb -h db01 --ini '/etc/sensu/my.cnf' --ini-section customsection
+#
+#   MY.CNF INI FORMAT
+#   [client]
+#   user=sensu
+#   password="abcd1234"
+#
+#   [customsection]
+#   user=user
+#   password="password"
+#
+
+require 'sensu-plugin/check/cli'
+require 'mysql'
+require 'inifile'
+
+class CheckMysqlReplicationStatus < Sensu::Plugin::Check::CLI
+  option :host,
+         short: '-h',
+         long: '--host=VALUE',
+         description: 'Database host'
+
+  option :port,
+         short: '-P',
+         long: '--port=VALUE',
+         description: 'Database port',
+         default: 3306,
+         # #YELLOW
+         proc: lambda { |s| s.to_i } # rubocop:disable Style/Lambda
+
+  option :socket,
+         short: '-s SOCKET',
+         long: '--socket SOCKET',
+         description: 'Socket to use'
+
+  option :user,
+         short: '-u',
+         long: '--username=VALUE',
+         description: 'Database username'
+
+  option :pass,
+         short: '-p',
+         long: '--password=VALUE',
+         description: 'Database password'
+
+  option :master_connection,
+         short: '-m',
+         long: '--master-connection=VALUE',
+         description: 'Replication master connection name'
+
+  option :ini,
+         short: '-i',
+         long: '--ini VALUE',
+         description: 'My.cnf ini file'
+
+  option :ini_section,
+         description: 'Section in my.cnf ini file',
+         long: '--ini-section VALUE',
+         default: 'client'
+
+  option :warn,
+         short: '-w',
+         long: '--warning=VALUE',
+         description: 'Warning threshold for replication lag',
+         default: 900,
+         # #YELLOW
+         proc: lambda { |s| s.to_i } # rubocop:disable Style/Lambda
+
+  option :crit,
+         short: '-c',
+         long: '--critical=VALUE',
+         description: 'Critical threshold for replication lag',
+         default: 1800,
+         # #YELLOW
+         proc: lambda { |s| s.to_i } # rubocop:disable Style/Lambda
+
+  def detect_replication_status?(row)
+    %w[
+      Slave_IO_State
+      Slave_IO_Running
+      Slave_SQL_Running
+      Last_IO_Error
+      Last_SQL_Error
+      Seconds_Behind_Master
+    ].all? { |key| row.key? key }
+  end
+
+  def slave_running?(row)
+    %w[
+      Slave_IO_Running
+      Slave_SQL_Running
+    ].all? { |key| row[key] =~ /Yes/ }
+  end
+
+  def run
+    if config[:ini]
+      ini = IniFile.load(config[:ini])
+      section = ini[config[:ini_section]]
+      db_user = section['user']
+      db_pass = section['password']
+    else
+      db_user = config[:user]
+      db_pass = config[:pass]
+    end
+    db_host = config[:host]
+    db_conn = config[:master_connection]
+
+    if [db_host, db_user, db_pass].any?(&:nil?)
+      unknown 'Must specify host, user, password'
+    end
+
+    begin
+      db = Mysql.new(db_host, db_user, db_pass, nil, config[:port], config[:socket])
+
+      results = if db_conn.nil?
+                  db.query 'SHOW SLAVE STATUS'
+                else
+                  db.query "SHOW SLAVE '#{db_conn}' STATUS"
+                end
+
+      unless results.nil?
+        results.each_hash do |row|
+          warn "couldn't detect replication status" unless detect_replication_status?(row)
+
+          slave_running = slave_running?(row)
+
+          output = if db_conn.nil?
+                     'Slave not running!'
+                   else
+                     "Slave on master connection #{db_conn} not running!"
+                   end
+
+          output += ' STATES:'
+          output += " Slave_IO_Running=#{row['Slave_IO_Running']}"
+          output += ", Slave_SQL_Running=#{row['Slave_SQL_Running']}"
+          output += ", LAST ERROR: #{row['Last_SQL_Error']}"
+
+          critical output unless slave_running
+
+          replication_delay = row['Seconds_Behind_Master'].to_i
+
+          message = "replication delayed by #{replication_delay}"
+
+          if replication_delay > config[:warn] &&
+             replication_delay <= config[:crit]
+            warning message
+          elsif replication_delay >= config[:crit]
+            critical message
+          elsif db_conn.nil?
+            ok "slave running: #{slave_running}, #{message}"
+          else
+            ok "master connection: #{db_conn}, slave running: #{slave_running}, #{message}"
+          end
+        end
+        ok 'show slave status was nil. This server is not a slave.'
+      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 StandardError => e
+      critical e
+    ensure
+      db.close if db
+    end
+  end
+end