PostgresMonitor
This gem is designed to expose a number of internal metrics and statistics for Postgres installations to the calling application. It borrows heavily from Heroku's PG Extras and Boundless's plugin for New Relic-- source.
In each case there were drawbacks that led me to create this gem. Heroku PG Extra's only works on Heroku installations. The New Relic plugin only accepts numerical values; I wanted to see the actual queries in some cases.
It uses the PG gem for its connections to Postgres
Installation
Add this line to your application's Gemfile:
gem 'postgres_monitor'
And then execute:
$ bundle
Or install it yourself as:
$ gem install postgres_monitor
Usage
Connection to the Database
To create a connection you will need to supply the host name, user, password (can be nil), and dbname. Port will default to 5432 if it is not provided. sslmode will default to required if it is not supplied.
Additionally there is a variable for configuring the long running query threshold. It defaults to '5 seconds' and follows the Postgres format for time intervals (e.g. '1 minute', '20 seconds')
Example
@connection_params = {
host: 'localhost',
port: nil, # defaults to 5432
user: 'postgres',
password: 'password',
sslmode: 'allow',
dbname: 'postrges'
long_query_threshold: '1 second'
}
@monitor = PostgresMonitor::Monitor.new(@connection_params)
Results from methods
The methods return the raw PG::Result for interpretation. This is a collection of hashes, well sometimes just one hash, with the results and keys in them.
Example
results = @monitor.list_databases
databases = []
results.each do |row|
databases << row['datname']
end
Development
After checking out the repo, run bin/setup
to install dependencies. Then, run rake rspec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/scottshea/postgres_monitor. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License
The gem is available as open source under the terms of the MIT License.