8. Запуск PGWatch2

Из консоли запустить сборщик метрик можно с помощью такой команды:

# pgwatch2-daemon 
  --host=localhost --user=pgwatch2 --dbname=pgwatch2 
  --datastore=postgres --pg-metric-store-conn-str=postgresql://pgwatch2@localhost:5432/pgwatch2_metrics 
  --verbose=info

Дальше идём в web-интерфейс и проверяем что на вкладке Stats summary появились значения для нашей базы данных:

Если всё работает, останавливаем сборку метрик с помощью «Ctr+c«. И настроим службу:

# nano /etc/systemd/system/pgwatch2.service
ExecStart=/usr/bin/pgwatch2-daemon --host=localhost --user=pgwatch2 --dbname=pgwatch2 --datastore=postgres --pg-metric-store-conn-str=postgresql://pgwatch2@localhost:5432/pgwatch2_metrics

Запустим службу и добавляем её в автозапуск:

# systemctl daemon-reload
# systemctl start pgwatch2.service
# systemctl enable pgwatch2.service
# systemctl status pgwatch2.service
● pgwatch2.service - Pgwatch2 Gathering Daemon
     Loaded: loaded (/etc/systemd/system/pgwatch2.service; disabled; vendor preset: enabled)
     Active: active (running) since Tue 2023-06-27 15:14:12 MSK; 11s ago
   Main PID: 14751 (pgwatch2-daemon)
      Tasks: 6 (limit: 4660)
     Memory: 7.7M
        CPU: 43ms
     CGroup: /system.slice/pgwatch2.service
             └─14751 /usr/bin/pgwatch2-daemon -c /etc/pgwatch2/config/instances.yaml -m /etc/pgwatch2/metrics --datastore=postgres

Следим, что метрики продолжают поступать!

9. Установка Grafana

Для визуализации полученных данных используется система Grafana.

Создадим базу данных для хранения конфигурации Grafana (пароль можете придумать свой):

# su - postgres -c psql

> CREATE USER pgwatch2_grafana PASSWORD 'xyz';
> CREATE DATABASE pgwatch2_grafana OWNER pgwatch2_grafana;
> exit

Установим Grafana:

# apt install adduser libfontconfig1 -y
# cd
# wget https://dl.grafana.com/oss/release/grafana_10.0.1_amd64.deb
# dpkg -i grafana_10.0.1_amd64.deb
# systemctl daemon-reload
# systemctl enable grafana-server

Перед запуском службы настроим Grafana, редактируя конфиг /etc/grafana/grafana.ini:

# nano /etc/grafana/grafana.ini
[database]
type = postgres
host = localhost:5432
name = pgwatch2_grafana
user = pgwatch2_grafana
password = xyz

[security]
admin_user = admin
admin_password = admin

Запустим Grafana:

# systemctl start grafana-server
# systemctl status grafana-server
● grafana-server.service - Grafana instance
     Loaded: loaded (/lib/systemd/system/grafana-server.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2023-06-27 17:02:53 MSK; 21h ago
       Docs: http://docs.grafana.org
   Main PID: 19670 (grafana)
      Tasks: 10 (limit: 4660)
     Memory: 85.5M
        CPU: 1min 17.633s
     CGroup: /system.slice/grafana-server.service
             └─19670 /usr/share/grafana/bin/grafana server --config=/etc/grafana/grafana.ini --pidfile=/run/grafana/grafana-server.pid

Проверим работу Grafana, перейдя в web-интерфейс (порт по умолчанию 3000). Логин и пароль мы задали выше в конфиге. Кстати, после входа вам предложат изменить пароль, что желательно сделать.

Установим базу данных метрик (pgwatch2_metrics) в качестве источника данных по умолчанию. Это делается через web-интерфейс (Administration / Data Sources):

Добавляем панели мониторинга (Dashboards) pgwatch2 в Grafana:

# cd /etc/pgwatch2/grafana-dashboards/
# ./import_all.sh

И наконец откроем Dashboards в Grafana:

Вот пример панели мониторинга DB Overview:

Здесь мы видим:

• Instance state (статус сервера) — PRIMARY или SLAVE;






• Instance uptime (uptime сервера);






• TPS (транзакций в секунду);






• QPS (запросов в секунду);






• Query runtime (среднее время выполнения запроса в миллисекундах);






• DB size ch. 1h (на сколько база выросла или уменьшилась за 1 час);






• Approx Table Bloat (примерное раздувание талицы);






• Tuples fetched vs returned (процентное отношение извлеченных данных к передаваемым, если менее 10%, вероятно у вас проблемы с индексами);






• Tuple ins. / upd. / del. statistics 5m avg (кортежей вставлено / обновлено / удалено в среднем за 5 минут);






• Shared Buffers hit ratio + Rollback ratio 5m avg (процент попадания в Shared Buffers + соотношение роллбэков);






• WAL rate + DB size (скорость записи WAL и размер базы данных);






• Session by state (количество сессий в разных состояниях);






• CPU load + avg. query runtime (загрузка ЦПУ + среднее время выполнение запроса);






• Seq. / Idx. scan (количество последовательных чтений и количество сканирований по индексу);






• Temp bytes (появляется, когда большие группы/сортировки не помещаются в Work Mem).