sensu-plugins-mysql 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3f33a1ae073b52dccd89fdf73543c66b45e48432
-  data.tar.gz: e5a88da4ae4bcf3d1d13238effdbbc38d3f50001
+  metadata.gz: 09befac0a6d69ea724280ceed0de5e745675a15b
+  data.tar.gz: 1361386396355226ae7d80fc47353a7144de726b
 SHA512:
-  metadata.gz: 0a1a0c0c2b9749c73bfd86b909f7d7d7738ec784185241a7612d9c0dccf5f87bbc29665208ad77cc113dd9e2ff4c441360ecf0cf78481cf38d6b3b57ddc81974
-  data.tar.gz: b012237ad2fd4945605821722a1a8944fb80b08ed5219e52995c7d2f0353f341b6b7e7d99ce828f4c1be10ef3b6f8b1b6ba4f8c6d0c76185fcbedd256e5729a6
+  metadata.gz: 256cb9c8249af6be2343b98d2bb1e9aba3fcaec0c7eb11748dd7610061a16c85a3f0bf8efd63de185e36ccdc292955ff7e0d2b0d48540d9206e99d5b0d4547a5
+  data.tar.gz: efe0cc759521f9e3883bc2b99119987fa8b1a83c029704f49e01315bd4380cbaae4586a48c3e9be41d65717e4454f975d4417734021f6c5adedb33dda8f370b9

data/CHANGELOG.md

@@ -5,6 +5,9 @@ This CHANGELOG follows the format listed at [Keep A Changelog](http://keepachang
 
 ## [Unreleased]
 
+## [1.2.0] - 2017-03-23
+- Add check-mysql-query-result-count.rb script (@athal7)
+
 ## [1.1.0] - 2017-01-15
 ### Added
 - Added minimum thresholds to the check-mysql-threads.rb script
@@ -51,7 +54,8 @@ This CHANGELOG follows the format listed at [Keep A Changelog](http://keepachang
 ### Added
 - initial release
 
-[Unreleased]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/1.1.0...HEAD
+[Unreleased]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/1.2.0...HEAD
+[1.2.0]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/1.1.0...1.2.0
 [1.1.0]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/1.0.0...1.1.0
 [1.0.0]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/0.0.4...1.0.0
 [0.0.4]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/0.0.3...0.0.4

data/README.md

@@ -16,6 +16,7 @@
  * bin/check-mysql-disk.rb
  * bin/check-mysql-innodb-lock.rb
  * bin/check-mysql-threads.rb
+ * bin/check-mysql-query-result-count.rb
  * bin/metrics-mysql-graphite.rb
  * bin/metrics-mysql-processes.rb
  * bin/metrics-mysql-raw.rb
@@ -45,6 +46,11 @@
 /opt/sensu/embedded/bin$ /opt/sensu/embedded/bin/ruby check-mysql-connections.rb --host=localhost --port=3306 --user=collectd --pass=tflypass --socket=/data/mysql.sock
 ```
 
+**check-mysql-query-result-count** example
+```bash
+/opt/sensu/embedded/bin$ /opt/sensu/embedded/bin/ruby check-mysql-query-result-count.rb --host=localhost --port=3306 --user=collectd --pass=tflypass --socket=/data/mysql.sock --warning 1 --critical 10 --query 'SELECT DISTINCT(t.id) FROM table t where t.failed = true'
+```
+
 ## Installation
 
 [Installation and Setup](http://sensu-plugins.io/docs/installation_instructions.html)
@@ -53,7 +59,7 @@
 The ruby executables are install in path similar to `/opt/sensu/embedded/lib/ruby/gems/2.0.0/gems/sensu-plugins-mysql-0.0.4/bin`
 
 ## Troubleshooting
-When used in `chef`, if the dependencies are missing, an error may abort the chef-client run: 
+When used in `chef`, if the dependencies are missing, an error may abort the chef-client run:
 ```bash
 *** extconf.rb failed ***
 Could not create Makefile due to some reason, probably lack of

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

@@ -0,0 +1,102 @@
+#!/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 :ini,
+         short: '-i',
+         long: '--ini VALUE',
+         description: 'My.cnf ini file'
+
+  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['client']
+      db_user = section['user']
+      db_pass = section['password']
+    else
+      db_user = config[:user]
+      db_pass = config[:password]
+    end
+    db = Mysql.real_connect(config[:hostname], 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 => e
+    critical e
+
+  ensure
+    db.close if db
+  end
+end

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

@@ -1,7 +1,7 @@
 module SensuPluginsMySql
   module Version
     MAJOR = 1
-    MINOR = 1
+    MINOR = 2
     PATCH = 0
 
     VER_STRING = [MAJOR, MINOR, PATCH].compact.join('.')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sensu-plugins-mysql
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Sensu-Plugins and contributors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-15 00:00:00.000000000 Z
+date: 2017-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: inifile
@@ -190,6 +190,7 @@ executables:
 - check-mysql-connections.rb
 - check-mysql-disk.rb
 - check-mysql-innodb-lock.rb
+- check-mysql-query-result-count.rb
 - check-mysql-replication-status.rb
 - check-mysql-status.rb
 - check-mysql-threads.rb
@@ -207,6 +208,7 @@ files:
 - bin/check-mysql-connections.rb
 - bin/check-mysql-disk.rb
 - bin/check-mysql-innodb-lock.rb
+- bin/check-mysql-query-result-count.rb
 - bin/check-mysql-replication-status.rb
 - bin/check-mysql-status.rb
 - bin/check-mysql-threads.rb