pghero 2.1.1 → 2.2.0

data/.gitattributes

@@ -1 +0,0 @@
-app/assets/* linguist-vendored

data/.github/ISSUE_TEMPLATE.md

@@ -1,7 +0,0 @@
-Hi,
-
-Before creating an issue, please check out the Contributing Guide:
-
-https://github.com/ankane/pghero/blob/master/CONTRIBUTING.md
-
-Thanks!

data/.gitignore

@@ -1,22 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-*.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log

data/.travis.yml

@@ -1,16 +0,0 @@
-language: ruby
-rvm: 2.4.4
-cache: bundler
-sudo: false
-script: TRAVIS_CI=1 bundle exec rake test
-addons:
-  postgresql: "9.4"
-before_install:
-  - gem update --system
-  - gem install bundler
-before_script:
-  - psql -c 'create database pghero_test;' -U postgres
-notifications:
-  email:
-    on_success: never
-    on_failure: change

data/Gemfile

@@ -1,6 +0,0 @@
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in pghero.gemspec
-gemspec
-
-gem "activerecord", "~> 5.2.0"

data/Rakefile

@@ -1,8 +0,0 @@
-require "bundler/gem_tasks"
-require "rake/testtask"
-
-task default: :test
-Rake::TestTask.new do |t|
-  t.libs << "test"
-  t.pattern = "test/**/*_test.rb"
-end

data/guides/Contributing.md

@@ -1,16 +0,0 @@
-# Contributing
-
-```sh
-git clone https://github.com/ankane/pghero.git
-git clone https://github.com/pghero/pghero.git pghero-dev
-cd pghero-dev
-git checkout dev
-createdb pghero_dev
-export DATABASE_URL=postgres:///pghero_dev
-bundle exec rails generate pghero:query_stats
-bundle exec rails generate pghero:space_stats
-bundle exec rake db:migrate
-foreman start
-```
-
-And visit [http://localhost:5000](http://localhost:5000)

data/guides/Docker.md

@@ -1,89 +0,0 @@
-# PgHero for Docker
-
-PgHero is available as a [Docker image](https://hub.docker.com/r/ankane/pghero/).
-
-```sh
-docker run -ti -e DATABASE_URL=postgres://user:password@hostname:5432/dbname -p 8080:8080 ankane/pghero
-```
-
-And visit [http://localhost:8080](http://localhost:8080).
-
-## Query Stats
-
-Query stats can be enabled from the dashboard. If you run into issues, [view the guide](Query-Stats.md).
-
-## Historical Query Stats
-
-To track query stats over time, create a table to store them.
-
-```sql
-CREATE TABLE "pghero_query_stats" (
-  "id" serial primary key,
-  "database" text,
-  "user" text,
-  "query" text,
-  "query_hash" bigint,
-  "total_time" float,
-  "calls" bigint,
-  "captured_at" timestamp
-);
-CREATE INDEX ON "pghero_query_stats" ("database", "captured_at");
-```
-
-Schedule the task below to run every 5 minutes.
-
-```sh
-docker run -ti -e DATABASE_URL=... ankane/pghero bin/rake pghero:capture_query_stats
-```
-
-After this, a time range slider will appear on the Queries tab.
-
-## Historical Space Stats
-
-To track space stats over time, create a table to store them.
-
-```sql
-CREATE TABLE "pghero_space_stats" (
-  "id" serial primary key,
-  "database" text,
-  "schema" text,
-  "relation" text,
-  "size" bigint,
-  "captured_at" timestamp
-);
-CREATE INDEX ON "pghero_space_stats" ("database", "captured_at");
-```
-
-Schedule the task below to run once a day.
-
-```sh
-docker run -ti -e DATABASE_URL=... ankane/pghero bin/rake pghero:capture_space_stats
-```
-
-## Multiple Databases
-
-Create a file at `/app/config/pghero.yml` with:
-
-```yml
-databases:
-  primary:
-    url: postgres://...
-  replica:
-    url: postgres://...
-```
-
-## Permissions
-
-We recommend [setting up a dedicated user](Permissions.md) for PgHero.
-
-## Security
-
-And basic authentication with:
-
-```sh
-docker run -e PGHERO_USERNAME=link -e PGHERO_PASSWORD=hyrule ...
-```
-
-## Credits
-
-Thanks to [Brian Morton](https://github.com/bmorton) for the [original Docker image](https://github.com/bmorton/pghero_solo).

data/guides/Heroku.md

@@ -1,102 +0,0 @@
-# PgHero for Heroku
-
-One click deployment
-
-[![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy?template=https://github.com/pghero/pghero)
-
-## Authentication
-
-Set the following variables in your environment.
-
-```sh
-heroku config:set PGHERO_USERNAME=link
-heroku config:set PGHERO_PASSWORD=hyrule
-```
-
-## Query Stats
-
-Query stats are enabled by default for Heroku databases - there’s nothing to do :tada:
-
-For databases outside of Heroku, query stats can be enabled from the dashboard.
-
-If you run into issues, [view the guide](Query-Stats.md).
-
-## Historical Query Stats
-
-To track query stats over time, create a table to store them.
-
-```sql
-CREATE TABLE "pghero_query_stats" (
-  "id" serial primary key,
-  "database" text,
-  "user" text,
-  "query" text,
-  "query_hash" bigint,
-  "total_time" float,
-  "calls" bigint,
-  "captured_at" timestamp
-)
-CREATE INDEX ON "pghero_query_stats" ("database", "captured_at")
-```
-
-This table can be in the current database or another database. If another database, run:
-
-```sh
-heroku config:set PGHERO_STATS_DATABASE_URL=...
-```
-
-Schedule the task below to run every 5 minutes.
-
-```sh
-rake pghero:capture_query_stats
-```
-
-Or with a scheduler like Clockwork, use:
-
-```ruby
-PgHero.capture_query_stats
-```
-
-After this, a time range slider will appear on the Queries tab.
-
-## System Stats
-
-CPU usage is available for Amazon RDS.  Add these variables to your environment:
-
-```sh
-heroku config:set PGHERO_ACCESS_KEY_ID=accesskey123
-heroku config:set PGHERO_SECRET_ACCESS_KEY=secret123
-heroku config:set PGHERO_DB_INSTANCE_IDENTIFIER=epona
-```
-
-## Customize
-
-Minimum time for long running queries
-
-```sh
-heroku config:set PGHERO_LONG_RUNNING_QUERY_SEC=60 # default
-```
-
-Minimum average time for slow queries
-
-```sh
-heroku config:set PGHERO_SLOW_QUERY_MS=20 # default
-```
-
-Minimum calls for slow queries
-
-```sh
-heroku config:set PGHERO_SLOW_QUERY_CALLS=100 # default
-```
-
-Minimum connections for high connections warning
-
-```sh
-heroku config:set PGHERO_TOTAL_CONNECTIONS_THRESHOLD=100 # default
-```
-
-Statement timeout for explain
-
-```sh
-heroku config:set PGHERO_EXPLAIN_TIMEOUT_SEC=10 # default
-````

data/guides/Linux.md

@@ -1,296 +0,0 @@
-# PgHero for Linux
-
-Distributions
-
-- [Ubuntu 16.04 (Xenial)](#ubuntu-1604-xenial)
-- [Ubuntu 14.04 (Trusty)](#ubuntu-1404-trusty)
-- [Debian 9 (Stretch)](#debian-9-stretch)
-- [Debian 8 (Jesse)](#debian-8-jesse)
-- [Debian 7 (Wheezy)](#debian-7-wheezy)
-- [CentOS / RHEL 7](#centos--rhel-7)
-- [SUSE Linux Enterprise Server 12](#suse-linux-enterprise-server-12)
-
-64-bit only
-
-## Installation
-
-### Ubuntu 16.04 (Xenial)
-
-```sh
-wget -qO- https://dl.packager.io/srv/pghero/pghero/key | sudo apt-key add -
-sudo wget -O /etc/apt/sources.list.d/pghero.list \
-  https://dl.packager.io/srv/pghero/pghero/master/installer/ubuntu/16.04.repo
-sudo apt-get update
-sudo apt-get -y install pghero
-```
-
-### Ubuntu 14.04 (Trusty)
-
-```sh
-wget -qO- https://dl.packager.io/srv/pghero/pghero/key | sudo apt-key add -
-sudo wget -O /etc/apt/sources.list.d/pghero.list \
-  https://dl.packager.io/srv/pghero/pghero/master/installer/ubuntu/14.04.repo
-sudo apt-get update
-sudo apt-get -y install pghero
-```
-
-### Debian 9 (Stretch)
-
-```sh
-sudo apt-get -y install apt-transport-https
-wget -qO- https://dl.packager.io/srv/pghero/pghero/key | sudo apt-key add -
-sudo wget -O /etc/apt/sources.list.d/pghero.list \
-  https://dl.packager.io/srv/pghero/pghero/master/installer/debian/9.repo
-sudo apt-get update
-sudo apt-get -y install pghero
-```
-
-### Debian 8 (Jesse)
-
-```sh
-sudo apt-get -y install apt-transport-https
-wget -qO- https://dl.packager.io/srv/pghero/pghero/key | sudo apt-key add -
-sudo wget -O /etc/apt/sources.list.d/pghero.list \
-  https://dl.packager.io/srv/pghero/pghero/master/installer/debian/8.repo
-sudo apt-get update
-sudo apt-get -y install pghero
-```
-
-### Debian 7 (Wheezy)
-
-```sh
-sudo apt-get -y install apt-transport-https
-wget -qO- https://dl.packager.io/srv/pghero/pghero/key | sudo apt-key add -
-sudo wget -O /etc/apt/sources.list.d/pghero.list \
-  https://dl.packager.io/srv/pghero/pghero/master/installer/debian/7.repo
-sudo apt-get update
-sudo apt-get -y install pghero
-```
-
-### CentOS / RHEL 7
-
-```sh
-sudo wget -O /etc/yum.repos.d/pghero.repo \
-  https://dl.packager.io/srv/pghero/pghero/master/installer/el/7.repo
-sudo yum -y install pghero
-```
-
-### SUSE Linux Enterprise Server 12
-
-```sh
-sudo wget -O /etc/zypp/repos.d/pghero.repo \
-  https://dl.packager.io/srv/pghero/pghero/master/installer/sles/12.repo
-sudo zypper install pghero
-```
-
-## Setup
-
-Add your database.
-
-```sh
-sudo pghero config:set DATABASE_URL=postgres://user:password@hostname:5432/dbname
-```
-
-And optional authentication.
-
-```sh
-sudo pghero config:set PGHERO_USERNAME=link
-sudo pghero config:set PGHERO_PASSWORD=hyrule
-```
-
-Start the server
-
-```sh
-sudo pghero config:set PORT=3001
-sudo pghero config:set RAILS_LOG_TO_STDOUT=disabled
-sudo pghero scale web=1
-```
-
-Confirm it’s running with:
-
-```sh
-curl -v http://localhost:3001/
-```
-
-To open to the outside world, add a proxy. Here’s how to do it with Nginx on Ubuntu.
-
-```sh
-sudo apt-get install -y nginx
-cat | sudo tee /etc/nginx/sites-available/default <<EOF
-server {
-  listen          80;
-  server_name     "";
-  location / {
-    proxy_pass    http://localhost:3001;
-  }
-}
-EOF
-sudo service nginx restart
-```
-
-## Management
-
-```sh
-sudo service pghero status
-sudo service pghero start
-sudo service pghero stop
-sudo service pghero restart
-```
-
-View logs
-
-```sh
-sudo pghero logs
-```
-
-## Query Stats
-
-Query stats can be enabled from the dashboard. If you run into issues, [view the guide](Query-Stats.md).
-
-## Historical Query Stats
-
-To track query stats over time, create a table to store them.
-
-```sql
-CREATE TABLE "pghero_query_stats" (
-  "id" serial primary key,
-  "database" text,
-  "user" text,
-  "query" text,
-  "query_hash" bigint,
-  "total_time" float,
-  "calls" bigint,
-  "captured_at" timestamp
-);
-CREATE INDEX ON "pghero_query_stats" ("database", "captured_at");
-```
-
-This table can be in the current database or another database. If another database, run:
-
-```sh
-sudo pghero config:set PGHERO_STATS_DATABASE_URL=...
-```
-
-Schedule the task below to run every 5 minutes.
-
-```sh
-sudo pghero run rake pghero:capture_query_stats
-```
-
-After this, a time range slider will appear on the Queries tab.
-
-## Historical Space Stats
-
-To track space stats over time, create a table to store them.
-
-```sql
-CREATE TABLE "pghero_space_stats" (
-  "id" serial primary key,
-  "database" text,
-  "schema" text,
-  "relation" text,
-  "size" bigint,
-  "captured_at" timestamp
-);
-CREATE INDEX ON "pghero_space_stats" ("database", "captured_at");
-```
-
-Schedule the task below to run once a day.
-
-```sh
-sudo pghero run rake pghero:capture_space_stats
-```
-
-## System Stats
-
-CPU usage is available for Amazon RDS.  Add these variables to your environment:
-
-```sh
-sudo pghero config:set PGHERO_ACCESS_KEY_ID=accesskey123
-sudo pghero config:set PGHERO_SECRET_ACCESS_KEY=secret123
-sudo pghero config:set PGHERO_DB_INSTANCE_IDENTIFIER=epona
-```
-
-## Multiple Databases
-
-Create a `pghero.yml` with:
-
-```yml
-databases:
-  primary:
-    url: postgres://...
-  replica:
-    url: postgres://...
-```
-
-And run:
-
-```sh
-cat pghero.yml | sudo pghero run sh -c "cat > config/pghero.yml"
-sudo service pghero restart
-```
-
-## Permissions
-
-We recommend [setting up a dedicated user](Permissions.md) for PgHero.
-
-## Customize
-
-Minimum time for long running queries
-
-```sh
-sudo pghero config:set PGHERO_LONG_RUNNING_QUERY_SEC=60 # default
-```
-
-Minimum average time for slow queries
-
-```sh
-sudo pghero config:set PGHERO_SLOW_QUERY_MS=20 # default
-```
-
-Minimum calls for slow queries
-
-```sh
-sudo pghero config:set PGHERO_SLOW_QUERY_CALLS=100 # default
-```
-
-Minimum connections for high connections warning
-
-```sh
-sudo pghero config:set PGHERO_TOTAL_CONNECTIONS_THRESHOLD=100 # default
-```
-
-Statement timeout for explain
-
-```sh
-sudo pghero config:set PGHERO_EXPLAIN_TIMEOUT_SEC=10 # default
-````
-
-## Upgrading
-
-Ubuntu and Debian
-
-```sh
-sudo apt-get update
-sudo apt-get install --only-upgrade pghero
-sudo service pghero restart
-```
-
-CentOS and RHEL
-
-```sh
-sudo yum update
-sudo yum install pghero
-sudo service pghero restart
-```
-
-SUSE
-
-```sh
-sudo zypper update pghero
-sudo service pghero restart
-```
-
-## Credits
-
-:heart: Made possible by [Packager](https://packager.io/)