sensu-plugins-postgres-mrtrotl 4.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b36a9f6c8350c240b747e19e5107550b6782a8db
+  data.tar.gz: fae743abe1278399494df6403584d5da8e496ace
+SHA512:
+  metadata.gz: 9da5a7f7ae02d98482e312d44b24340abc0cbc0fa6ee86bf874e08604113f14be46cdf955ae808a0e43cffc5ab68f3c6990890b048b39ec27b68a8486cf25a99
+  data.tar.gz: df7b32f6212e6fc56ba73655f91f4949b88bdc1e1efbd7ba6b419241f7e31247d08474195d892b4c5a09740cdd67ee29f1ea8ad18c9acc21bee30cf41338a14a

data/CHANGELOG.md

@@ -0,0 +1,277 @@
+# Change Log
+This project adheres to [Semantic Versioning](http://semver.org/).
+
+This CHANGELOG follows the format listed [here](https://github.com/sensu-plugins/community/blob/master/HOW_WE_CHANGELOG.md).
+
+## [Unreleased]
+
+### Breaking Changes
+- Updated asset builds to use ruby26-runtime
+- Update asset builds to use libpg v12, to ensue compatibility with SCRAM password authentication introduced in postgresl 10
+
+### Fixed
+- Standardize on 10 second integer for timeout option to ensure working defaults with libpg. Newer libpg libraries don't like the nil default, treats it as a string and errors out.
+
+## [4.3.0] - 2021-09-15
+
+### Added
+- asset for generic debian build (including ubuntu) (@VeselaHouba)
+
+### Fixed
+- Fixing asset build directive for centos6, using package repository archive now that centos6 is EOL
+
+## [4.2.0] - 2020-11-29
+### Added
+- new `bin/metric-postgres-relation-size.rb` find largest tables (@phumpal)
+
+## [4.1.0] - 2020-06-04
+### Added
+- new `metric-postgres-vaccum.rb` metric gathering script for postgres vacuum process (@phumpal)
+
+## [4.0.2] - 2020-06-02
+- Fixed `# frozen_string_literal: true` does not play nicely with mixlib-cli.
+
+## [4.0.1] - 2020-04-20
+### Fixed
+- Fixing asset build directives.
+
+## [4.0.0] - 2020-01-09
+
+### Breaking Changes
+- Update `sensu-plugin` dependency from `~> 1.2` to `~> 4.0` you can read the changelog entries for [4.0](https://github.com/sensu-plugins/sensu-plugin/blob/master/CHANGELOG.md#400---2018-02-17), [3.0](https://github.com/sensu-plugins/sensu-plugin/blob/master/CHANGELOG.md#300---2018-12-04), and [2.0](https://github.com/sensu-plugins/sensu-plugin/blob/master/CHANGELOG.md#v200---2017-03-29)
+- `check-postgres-replication.rb`: both `--slave-host` and `master-host` arguments are now required flags where previously they had localhost defaults (@phumpal)
+
+### Fixed
+- `check-postgres-replication.rb`: fix condition where connection timeout is considered a boolean rather than an integer value (@majormoses) (@phumpal) (@VeselaHouba)
+- `check-postgres-replication.rb`: critical if the master and slave are same (@phumpal)
+
+### Added
+- `check-postgres-query.rb`: Add `-r`, `--regex-pattern` to match query result against (@jindraj)
+
+### Changes
+- Updated development dependency to bundler ~> 2.1
+- Updated development dependency to rake ~> 13.0
+- Updated development dependency to test-kitchen ~> 1.25.0
+- Updated runtime dependency to 'pg' '1.2.1' from 1.1
+- Updated runtime dependency 'dentaku' '3.3.4' from 2.04
+
+## [3.0.0] - 2019-11-20
+### Breaking Changes
+- Removed ruby < 2.4 since these Rubies are EOL (@phumpal)
+
+## [2.4.0] - 2019-10-04
+### Added
+- Support comments in pgpass file. Keeps previous behavior and adds support for ignoring leading comments (@phumpal)
+
+## [2.3.2] - 2019-03-12
+### Fixed
+- Support for PostgreSQL v10+ replication function names fixed in `bin/metric-postgres-graphite.rb` (@jfineberg)
+
+## [2.3.1] - 2018-12-16
+### Fixed
+- metric-postgres-statsdb.rb: Change `Array` method from `append` to `push` to maintain compatibility w/ non-EOL Rubies (@phumpal)
+
+## [2.3.0] - 2018-12-08
+### Added
+- metric-postgres-statsdb.rb: Add --all-databases option. (@cyrilgdn)
+
+## [2.2.2] - 2018-10-27
+### Fixed
+- Remove unexplicit dependency on ActiveSupport (@multani)
+
+## [2.2.1] - 2018-10-16
+### Security
+- updated yard dependency to `~> 0.9.11` per: https://nvd.nist.gov/vuln/detail/CVE-2017-17042 (@majormoses)
+
+## [2.2.0] - 2018-10-16
+### Added
+- metric-postgres-statsbgwriter.rb: additional metrics (@phumpal)
+- metric-postgres-statsdb.rb additional metrics (@phumpal)
+
+## [2.1.0] - 2018-10-16
+### Added
+- Moves check_vsn and compute_lag to library method (@phumpal)
+
+## [2.0.0] - 2018-10-15
+### Breaking Changes
+- Remove unsupported Rubies: `< 2.3.0` (@phumpal)
+
+## [1.4.6] - 2018-05-03
+### Fixed
+- version number check for build strings such as `10.3 (Ubuntu 10.3-1.pgdg16.04+1)` (@jfineberg)
+
+### Added
+- tests for connecting with a pgpass file (@majormoses)
+
+## [1.4.5] - 2018-02-15
+### Fixed
+- metric-postgres-graphite.rb: use the custom defined port when connecting to slave (@henkjan)
+
+### Added
+- basic skel for integration testing with postgres (@majormoses)
+- added test for `./bin/check-postgres-alive.rb`
+
+## [1.4.4] - 2017-11-08
+### Fixed
+- check-postgres-replication.rb: fix 9.x compatibility
+
+## [1.4.3] - 2017-11-06
+### Fixed
+- check-postgres-replication.rb: maintains backwards compatibility with <= 9.6 and adds compatibility for >= 10
+
+## [1.4.2] - 2017-09-27
+### Fixed
+- metric-postgres-locks.rb: Fix lock count collection (@madboxkr)
+
+## [1.4.1] - 2017-09-26
+### Fixed
+- metrics-postgres-query.rb: Add a nil check to avoid failure when the query result is empty (@eheydrick)
+- PR template spelling (@majormoses)
+
+### Changed
+- updated CHANGELOG guidelines location (@majormoses)
+
+## [1.4.0] - 2017-08-04
+### Added
+- all checks now support using the pgpass file and is backwards compatible with the previous versions (@ahes)
+
+## [1.3.0] - 2017-07-25
+### Fixed
+- Take into account reserved superuser connections in check-postgres-connections.rb (@Evesy)
+
+### Added
+- Ruby 2.4.1 testing
+
+## [1.2.0] - 2017-07-12
+### Added
+- metric-postgres-statsdb.rb: Adds new metric `numbackends`. (@phumpal)
+
+## [1.1.2] - 2017-06-02
+### Fixed
+- check-postgresq-replication.rb: Adds missing option for custom port.
+
+## [1.1.1] - 2017-04-24
+### Fixed
+- metrics-postgres-query.rb: Restored default value to only return first value in query. (@Micasou)
+
+## [1.1.0] - 2017-04-20
+### Added
+- metrics-postgres-query.rb: Add option to return multi row queries. (@Micasou)
+
+### Fixed
+- check-postgres-alive.rb: Fix connections using a custom port (#25 via @mickfeech)
+- check-postgres-connections.rb: Fix connections using a custom port (#25)
+- check-postgres-query.rb: Fix connections using a custom port (#25)
+- check-postgres-replication.rb: Fix connections using a custom port (#25)
+- metrics-postgres-connections.rb: Fix connections using a custom port (#25)
+- metrics-postgres-dbsize.rb: Fix connections using a custom port (#25)
+- metrics-postgres-graphite.rb: Fix connections using a custom port (#25)
+- metrics-postgres-graphite.rb: Fix connections using password (@teadur)
+- metrics-postgres-locks.rb: Fix connections using a custom port (#25)
+- metrics-postgres-statsgbwriter.rb: Fix connections using a custom port (#25)
+- metrics-postgres-statsdb.rb: Fix connections using a custom port (#25)
+- metrics-postgres-statsio.rb: Fix connections using a custom port (#25)
+- metrics-postgres-statstable.rb: Fix connections using a custom port (#25)
+- metrics-postgres-query.rb: Fix connections using a custom port (#25)
+- check-postgres-connections.rb: Fix logic to check critical first then warning (#24 via @nevins-b)
+
+## [1.0.1] - 2017-01-04
+### Fixed
+- metrics-postgres-query.rb: Fix `count_tuples` option (#23) (@eheydrick)
+
+## [1.0.0] - 2016-12-27
+### Fixed
+- metric-postgres-connections: Handle postgres version 9.6 and above.
+
+### Removed
+- Ruby 1.9.3 and 2.0.0 support
+
+### Added
+- Ruby 2.3.0 support
+- Update all the scripts to add an optional timeout setting.
+
+## [0.1.1] - 2016-03-24
+### Added
+- metric-postgres-connections: Add new metric `total`
+
+### Fixed
+- metric-postgres-connections: Correctly evaluate and collect metrics for active connections and active connections waiting on backend locks
+
+## [0.1.0] - 2016-03-09
+### Added
+- Add new plugin `check-postgres-connections` that checks the number of connections to a DB
+
+## [0.0.7] - 2015-12-10
+### Changed
+- fixed [ -S | -ssl ] short option
+
+## [0.0.6] - 2015-10-08
+### Changed
+- standardized headers
+
+### Added
+- added plugins for querying postgres
+
+## [0.0.5] - 2015-10-06
+### Changed
+- updated pg gem to 0.18.3
+- Added port cli option to postgres-graphite.rb.
+
+## [0.0.4] - 2015-08-04
+### Changed
+- general cleanup, no code changes
+
+## [0.0.3] - 2015-07-14
+### Changed
+- updated sensu-plugin gem to 1.2.0
+
+## [0.0.2] - 2015-06-03
+### Fixed
+- added binstubs
+
+### Changed
+- removed cruft from /lib
+
+## 0.0.1 - 2015-04-30
+### Added
+- initial release
+
+[Unreleased]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/4.3.0...HEAD
+[4.3.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/4.2.0...4.3.0
+[4.2.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/4.1.0...4.2.0
+[4.1.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/4.0.2...4.1.0
+[4.0.2]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/4.0.1...4.0.2
+[4.0.1]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/4.0.0...4.0.1
+[4.0.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/3.0.0...4.0.0
+[3.0.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.4.0...3.0.0
+[2.4.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.3.2...2.4.0
+[2.3.2]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.3.1...2.3.2
+[2.3.1]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.3.0...2.3.1
+[2.3.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.2.2...2.3.0
+[2.2.2]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.2.1...2.2.2
+[2.2.1]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.2.0...2.2.1
+[2.2.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.1.0...2.2.0
+[2.1.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/2.0.0...2.1.0
+[2.0.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.4.6...2.0.0
+[1.4.6]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.4.5...1.4.6
+[1.4.5]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.4.4...1.4.5
+[1.4.4]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.4.3...1.4.4
+[1.4.3]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.4.2...1.4.3
+[1.4.2]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.4.1...1.4.2
+[1.4.1]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.4.0...1.4.1
+[1.4.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.3.0...1.4.0
+[1.3.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.2.0...1.3.0
+[1.2.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.1.2...1.2.0
+[1.1.2]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.1.1...1.1.2
+[1.1.1]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.1.0...1.1.1
+[1.1.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.0.1...1.1.0
+[1.0.1]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/1.0.0...1.0.1
+[1.0.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.1.1...1.0.0
+[0.1.1]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.1.0...0.1.1
+[0.1.0]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.0.7...0.1.0
+[0.0.7]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.0.6...0.0.7
+[0.0.6]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.0.5...0.0.6
+[0.0.5]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.0.4...0.0.5
+[0.0.4]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.0.3...0.0.4
+[0.0.3]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.0.2...0.0.3
+[0.0.2]: https://github.com/sensu-plugins/sensu-plugins-postgres/compare/0.0.1...0.0.2

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,125 @@
+## Sensu-Plugins-postgres
+
+[![Build Status](https://travis-ci.org/sensu-plugins/sensu-plugins-postgres.svg?branch=master)](https://travis-ci.org/sensu-plugins/sensu-plugins-postgres)
+[![Gem Version](https://badge.fury.io/rb/sensu-plugins-postgres.svg)](http://badge.fury.io/rb/sensu-plugins-postgres)
+[![Code Climate](https://codeclimate.com/github/sensu-plugins/sensu-plugins-postgres/badges/gpa.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-postgres)
+[![Test Coverage](https://codeclimate.com/github/sensu-plugins/sensu-plugins-postgres/badges/coverage.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-postgres)
+[![Dependency Status](https://gemnasium.com/sensu-plugins/sensu-plugins-postgres.svg)](https://gemnasium.com/sensu-plugins/sensu-plugins-postgres)
+
+## Functionality
+
+## Files
+ * bin/check-postgres-alive.rb
+ * bin/check-postgres-connections.rb
+ * bin/metric-postgres-dbsize.rb
+ * bin/metric-postgres-statsbgwriter.rb
+ * bin/metric-postgres-statstable.rb
+ * bin/check-postgres-replication.rb
+ * bin/metric-postgres-graphite.rb
+ * bin/metric-postgres-statsdb.rb
+ * bin/metric-postgres-connections.rb
+ * bin/metric-postgres-locks.rb
+ * bin/metric-postgres-statsio.rb
+ * bin/check-postgres-query.rb
+ * bin/metrics-postgres-query.rb
+ * bin/metric-postgres-relation-size.rb
+
+## Usage
+
+Use `--help` to see command arguments.
+
+### Sample usage
+
+#### Check if PostgreSQL is alive
+```
+$ check-postgres-alive.rb -d template1 -f /var/lib/postgresql/.pgpass
+CheckPostgres OK: Server version: {"version"=>"PostgreSQL 9.6.3 on x86_64-pc-linux-gnu, compiled by gcc (Debian 4.9.2-10) 4.9.2, 64-bit"}
+```
+
+### Check replication status
+```
+$ check-postgres-replication.rb -m psql1.local -s psql2.local -d template1 -w 5 -c 10
+CheckPostgresReplicationStatus OK: replication delayed by 0.0MB :: master:B0/B4031000 slave:B0/B4031000 m_segbytes:16777216
+```
+
+### Check number of connections
+```
+$ export PGPASSWORD=this-is-secret-password
+$ check-postgres-connections.rb -a -w 80 -c 90 -d template1 -u sensu
+CheckPostgresConnections OK: PostgreSQL connections under threshold: 17%, 174 out of 997 connections
+```
+
+### Default values
+
+| Argument       | Env variable | Value     |
+|----------------|--------------|-----------|
+| -f, --pgpass   | PGPASSFILE   | ~/.pgpass |
+| -h, --hostname | PGHOST       | localhost |
+| -P, --port     | PGPORT       | 5432      |
+| -d, --database | PGDATABASE   | postgres  |
+| -u, --user     | PGUSER       | postgres  |
+| -p, --password | PGPASSWORD   |           |
+
+Options precedence is following:
+1. command line arguments
+1. pgpass file
+1. env variables
+1. defaults
+
+### Pgpass file
+
+When file `~/.pgpass` is found it is used by default. You can also use `-f, --pgpass` command line argument or set `PGPASSFILE` env variable.
+
+File format is:
+
+```
+hostname:port:database:username:password
+```
+
+Only first line is used. If database is set to `*` it is ommited.
+
+You can ovveride `pgpass` values with command line arguments, e.g. `-h` for hostname.
+
+
+## Installation
+### Sensu Go Asset Installation
+
+Assets are the best way to make use of this plugin in Sensu Go. If you're not using an asset, please consider doing so! If you're using sensuctl 5.13 or later, you can use the following command to add the asset:
+
+sensuctl asset add sensu-plugins/sensu-plugins-postgresl
+
+If you're using an earlier version of sensuctl, you can download the asset definition from this project's Bonsai Asset Index page.
+
+Note: as of version 4.0.0 the plugin assets are built using the sensu-ruby26-runtime, and will also require that you have the sensu-ruby26-runtime asset and installed as part of the check configuration.
+
+
+### Gem Installation
+If you are unable to use the provided Sensu asset package, you can install this plugin via rubygems on a system that have ruby available.
+
+```
+gem install sensu-plugins-postgres
+```
+
+
+See [Installation and Setup](http://sensu-plugins.io/docs/installation_instructions.html) for details.
+
+### Known issues
+
+When using Sensu with `EMBEDDED_RUBY=true` and installing Postgres checks with `/usr/bin/sensu-install -p sensu-plugins-postgres` you might get following error:
+
+```
+ERROR:  Error installing sensu-plugins-postgres:
+	ERROR: Failed to build gem native extension.
+[...]
+checking for PQconnectdb() in -lpq... no
+checking for PQconnectdb() in -llibpq... no
+checking for PQconnectdb() in -lms/libpq... no
+Can't find the PostgreSQL client library (libpq)
+*** extconf.rb failed ***
+```
+
+The reason is that **libssl** library which comes with Sensu is incompatible with **libpq** library installed on your system. There is no easy way to fix it. You might want to install sensu-plugins-postgres globally with `gem install sensu-plugins-postgres`.
+
+Checks are in `/usr/local/bin` directory.
+
+## Notes

data/bin/check-postgres-alive.rb

@@ -0,0 +1,94 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: false
+
+#
+#   check-postgres-alive
+#
+# DESCRIPTION:
+#
+#   This plugin attempts to login to postgres with provided credentials.
+#
+# OUTPUT:
+#   plain text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: sensu-plugin
+#   gem: pg
+#
+# USAGE:
+#   ./check-postgres-alive.rb -u db_user -p db_pass -h db_host -d db
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright (c) 2012 Lewis Preson & Tom Bassindale
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugins-postgres/pgpass'
+require 'sensu-plugin/check/cli'
+require 'pg'
+
+class CheckPostgres < Sensu::Plugin::Check::CLI
+  option :pgpass,
+         description: 'Pgpass file',
+         short: '-f FILE',
+         long: '--pgpass',
+         default: ENV['PGPASSFILE'] || "#{ENV['HOME']}/.pgpass"
+
+  option :user,
+         description: 'Postgres User',
+         short: '-u USER',
+         long: '--user USER'
+
+  option :password,
+         description: 'Postgres Password',
+         short: '-p PASS',
+         long: '--password PASS'
+
+  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'
+
+  option :port,
+         description: 'Database port',
+         short: '-P PORT',
+         long: '--port PORT'
+
+  option :timeout,
+         description: 'Connection timeout (seconds)',
+         short: '-T TIMEOUT',
+         long: '--timeout TIMEOUT',
+         default: 10,
+         proc: proc(&:to_i)
+
+  include Pgpass
+
+  def run
+    pgpass
+    con = PG.connect(host: config[:hostname],
+                     dbname: config[:database],
+                     user: config[:user],
+                     password: config[:password],
+                     port: config[:port],
+                     connect_timeout: config[:timeout])
+    res = con.exec('select version();')
+    info = res.first
+
+    ok "Server version: #{info}"
+  rescue PG::Error => e
+    critical "Error message: #{e.error.split("\n").first}"
+  ensure
+    con&.close
+  end
+end

data/bin/check-postgres-connections.rb

@@ -0,0 +1,142 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: false
+
+#
+# check-postgres-connections
+#
+# DESCRIPTION:
+#   This plugin checks the number of connections to a postgresql database and
+#   alerts when the number or percent crosses a threshold. Defaults to checking
+#   number of connections unless the --percentage flag is used in which case the
+#   percentage of max connections is checked.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: pg
+#   gem: sensu-plugin
+#
+# USAGE:
+#   # warn when connections hit 250, critical when 400
+#   check-postgres-connections.rb -u db_user -p db_pass -h db_host -d db -w 250 -c 400
+#   # warn when connections hit 80%, critical when 95%
+#   check-postgres-connections.rb -u db_user -p db_pass -h db_host -d db -w 80 -c 95 --percentage
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright 2016, Eric Heydrick <eheydrick@gmail.com>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugins-postgres/pgpass'
+require 'sensu-plugin/check/cli'
+require 'pg'
+
+class CheckPostgresConnections < Sensu::Plugin::Check::CLI
+  option :pgpass,
+         description: 'Pgpass file',
+         short: '-f FILE',
+         long: '--pgpass',
+         default: ENV['PGPASSFILE'] || "#{ENV['HOME']}/.pgpass"
+
+  option :user,
+         description: 'Postgres User',
+         short: '-u USER',
+         long: '--user USER'
+
+  option :password,
+         description: 'Postgres Password',
+         short: '-p PASS',
+         long: '--password PASS'
+
+  option :hostname,
+         description: 'Hostname to login to',
+         short: '-h HOST',
+         long: '--hostname HOST'
+
+  option :port,
+         description: 'Database port',
+         short: '-P PORT',
+         long: '--port PORT'
+
+  option :database,
+         description: 'Database name',
+         short: '-d DB',
+         long: '--db DB'
+
+  option :warning,
+         description: 'Warning threshold number or % of connections. (default: 200 connections)',
+         short: '-w WARNING',
+         long: '--warning WARNING',
+         default: 200,
+         proc: proc(&:to_i)
+
+  option :critical,
+         description: 'Critical threshold number or % of connections. (default: 250 connections)',
+         short: '-c CRITICAL',
+         long: '--critical CRITICAL',
+         default: 250,
+         proc: proc(&:to_i)
+
+  option :use_percentage,
+         description: 'Use percentage of max connections used instead of the absolute number of connections',
+         short: '-a',
+         long: '--percentage',
+         boolean: true,
+         default: false
+
+  option :timeout,
+         description: 'Connection timeout (seconds)',
+         short: '-T TIMEOUT',
+         long: '--timeout TIMEOUT',
+         default: 10,
+         proc: proc(&:to_i)
+
+  include Pgpass
+
+  def run
+    begin
+      pgpass
+      con = PG.connect(host: config[:hostname],
+                       dbname: config[:database],
+                       user: config[:user],
+                       password: config[:password],
+                       port: config[:port],
+                       connect_timeout: config[:timeout])
+      max_conns = con.exec('SHOW max_connections').getvalue(0, 0).to_i
+      superuser_conns = con.exec('SHOW superuser_reserved_connections').getvalue(0, 0).to_i
+      available_conns = max_conns - superuser_conns
+      current_conns = con.exec('SELECT count(*) from pg_stat_activity').getvalue(0, 0).to_i
+    rescue PG::Error => e
+      unknown "Unable to query PostgreSQL: #{e.message}"
+    end
+
+    percent = (current_conns / max_conns.to_f * 100).to_i
+
+    if config[:use_percentage]
+      message = "PostgreSQL connections at #{percent}%, #{current_conns} out of #{available_conns} connections"
+      if percent >= config[:critical]
+        critical message
+      elsif percent >= config[:warning]
+        warning message
+      else
+        ok "PostgreSQL connections under threshold: #{percent}%, #{current_conns} out of #{available_conns} connections"
+      end
+    else
+      message = "PostgreSQL connections at #{current_conns} out of #{available_conns} connections"
+      if current_conns >= config[:critical]
+        critical message
+      elsif current_conns >= config[:warning]
+        warning message
+      else
+        ok "PostgreSQL connections under threshold: #{current_conns} out of #{available_conns} connections"
+      end
+    end
+  end
+end