sensu-plugins-mysql 2.2.1 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: baddc0a5723b41abb3ac70c992d6e187ec596ae8873f55b45603128763a7087f
-  data.tar.gz: 7a0c548a8a354e74200f5305289a3560fa646c1c30c469ea27fe7d92850c0538
+SHA1:
+  metadata.gz: b5e5653712ab73a7fb12a37a97c8472ffab497df
+  data.tar.gz: 556cff86d0e9ceb1a7a2954527f858a2e5b7be1b
 SHA512:
-  metadata.gz: 73798587a0a64f42d7e80f1254cad4762484bcd59790d979eb5841f323391ba342803f0e575df33af23095d986ceec775631c9bee30a8474ddef88c4e9724b9c
-  data.tar.gz: c5afa4efa3be6434402ead37d0820d3d941561dd79f89fa87c5d1ada804d6548160f7ceb6f7a30e8c010d40428c82c229d84cd9560bddee275088b2a6c30a6c3
+  metadata.gz: 0166be616c39d39a56314c683e3f91fe09aad4cdad696a34a5115fb14fcc2f77ff389e149f5733d523e36c290719189f1ab3279f57f919bc6b900e20209e2c39
+  data.tar.gz: 900c46efc192ba7c71b9ac3d975dd924e6ffc9beec6e75f366178e0498a6e6041219de8db613a8cdfe09d2e8381fb8c237c3ae717badde9a8d5ef5414d2205b7

data/CHANGELOG.md

@@ -5,6 +5,13 @@ This CHANGELOG follows the format listed [here](https://github.com/sensu-plugins
 
 ## [Unreleased]
 
+## [2.3.0] - 2018-03-17
+### Added
+- check-mysql-msr-replication-status.rb: new script that helps with monitoring mysql multi-source replication (@ndelic0)
+
+### Changed
+- appeased cops (@majormoses)
+
 ## [2.1.1] - 2018-02-07
 ### Fixed
 - check-mysql-status.rb: if --socket flag is specified, it overrides config (@tinle)
@@ -114,7 +121,8 @@ This CHANGELOG follows the format listed [here](https://github.com/sensu-plugins
 ### Added
 - initial release
 
-[Unreleased]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/2.2.1...HEAD
+[Unreleased]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/2.3.0...HEAD
+[2.3.0]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/2.2.1...2.3.0
 [2.2.1]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/2.2.0..2.2.1
 [2.2.0]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/2.1.1...2.2.0
 [2.1.2]: https://github.com/sensu-plugins/sensu-plugins-mysql/compare/2.1.1...2.1.2

data/README.md

@@ -17,6 +17,7 @@
  * bin/check-mysql-innodb-lock.rb
  * bin/check-mysql-threads.rb
  * bin/check-mysql-query-result-count.rb
+ * bin/check-mysql-msr-replication-status.rb
  * bin/metrics-mysql-graphite.rb
  * bin/metrics-mysql-processes.rb
  * bin/metrics-mysql-raw.rb
@@ -76,6 +77,11 @@ $ /opt/sensu/embedded/bin/check-mysql-threads.rb --host=<DBHOST> --ini=/etc/sens
 $ /opt/sensu/embedded/bin/check-mysql-replication-status.rb --host=<SLAVE> --ini=/etc/sensu/my.ini
 ```
 
+**check-mysql-msr-replication-status** example
+```bash
+$ /opt/sensu/embedded/bin/check-mysql-replication-status.rb --host=<SLAVE> --ini=/etc/sensu/my.ini
+```
+
 **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'
@@ -98,6 +104,7 @@ In keeping with the principle of least privilege you should create a new user wi
 | check-mysql-innodb-lock.rb             | `PROCESS`                                                 |
 | check-mysql-query-result-count.rb      | depends on query                                          |
 | check-mysql-replication-status.rb      | `SUPER` OR `REPLICATION_CLIENT` (the latter is preferable)|
+| check-mysql-msr-replication-status.rb  | `SELECT`                                                  |
 | check-mysql-status.rb                  | `SELECT`                                                  |
 | check-mysql-threads.rb                 | `SELECT`                                                  |
 | metrics-mysql-graphite.rb              | `SELECT`                                                  |

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

@@ -0,0 +1,153 @@
+#!/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 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 = 0
+          if io_thread_status == 'No' || sql_thread_status == 'No' || seconds_behind_master > config[:crit]
+            status = 2
+          end
+          if seconds_behind_master > config[:warn] && seconds_behind_master <= config[:crit]
+            status = 1
+          end
+          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.zero?
+            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/lib/sensu-plugins-mysql/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sensu-plugins-mysql
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.3.0
 platform: ruby
 authors:
 - Sensu-Plugins and contributors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-07 00:00:00.000000000 Z
+date: 2018-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: inifile
@@ -186,19 +186,20 @@ description: |-
                                 sending metrics to a MySQL database.
 email: "<sensu-users@googlegroups.com>"
 executables:
-- check-mysql-alive.rb
-- check-mysql-connections.rb
+- metrics-mysql-query-result-count.rb
 - check-mysql-disk.rb
+- metrics-mysql.rb
 - check-mysql-innodb-lock.rb
+- check-mysql-alive.rb
 - check-mysql-query-result-count.rb
+- metrics-mysql-graphite.rb
 - check-mysql-replication-status.rb
-- check-mysql-status.rb
 - check-mysql-threads.rb
-- metrics-mysql-graphite.rb
+- check-mysql-msr-replication-status.rb
 - metrics-mysql-processes.rb
-- metrics-mysql-query-result-count.rb
 - metrics-mysql-raw.rb
-- metrics-mysql.rb
+- check-mysql-connections.rb
+- check-mysql-status.rb
 extensions: []
 extra_rdoc_files: []
 files:
@@ -209,6 +210,7 @@ files:
 - bin/check-mysql-connections.rb
 - bin/check-mysql-disk.rb
 - bin/check-mysql-innodb-lock.rb
+- bin/check-mysql-msr-replication-status.rb
 - bin/check-mysql-query-result-count.rb
 - bin/check-mysql-replication-status.rb
 - bin/check-mysql-status.rb
@@ -247,7 +249,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.5
+rubygems_version: 2.5.2.1
 signing_key: 
 specification_version: 4
 summary: Sensu plugins for MySql