PgHero

Database insights made easy

View the demo

Supports PostgreSQL 9.2+

For pure SQL, check out PgHero.sql

A big thanks to Craig Kerstiens and Heroku for the initial queries 👏

Installation

Add this line to your application’s Gemfile:

gem 'pghero'

And mount the dashboard in your router.

mount PgHero::Engine, at: "pghero"

Be sure to secure the dashboard in production.

Insights

PgHero.running_queries
PgHero.long_running_queries
PgHero.index_usage
PgHero.missing_indexes
PgHero.unused_indexes
PgHero.unused_tables
PgHero.database_size
PgHero.relation_sizes
PgHero.index_hit_rate
PgHero.table_hit_rate

# kill queries
PgHero.kill(pid)
PgHero.kill_all

Security

Basic Authentication

Set the following variables in your environment or an initializer.

ENV["PGHERO_USERNAME"] = "andrew"
ENV["PGHERO_PASSWORD"] = "secret"

Devise

authenticate :user, lambda {|user| user.admin? } do
  mount PgHero::Engine, at: "pghero"
end

TODO

• show exactly which indexes to add
• use pg_stat_statements extension for more detailed insights
• more detailed explanations on dashboard

Know a bit about PostgreSQL? Suggestions are greatly appreciated.

Thanks

Thanks to Craig Kerstiens and Heroku for the initial queries and Bootswatch for the theme.

History

View the changelog

Contributing

Everyone is encouraged to help improve this project. Here are a few ways you can help:

• Report bugs
• Fix bugs and submit pull requests
• Write, clarify, or fix documentation
• Suggest or add new features