Загрузка и установка

Официальные выпуски, пакеты, требования и установка из исходного кода

Руководство

Выбор канала распространения

Канал	Для чего использовать	Где находится
Официальный выпуск	Архивы исходного кода и примечания к выпуску	Выпуски GitHub
Пакет RPM	Дистрибутивы Linux на базе RPM	Репозиторий PostgreSQL Yum
Пакет Debian/Ubuntu	Дистрибутивы Linux на базе APT	Репозиторий PostgreSQL Apt
Разрабатываемый исходный код	Текущий код, ещё не вошедший в выпуск	darold/pgbadger

В примерах установки используется pgBadger 13.2. Перед загрузкой проверьте нужную версию на странице выпусков.

Требования

Для создания HTML-отчётов нужны только:

современная поставка Perl;
веб-браузер для отображения встроенных диаграмм JavaScript.

Для необязательных возможностей требуются следующие зависимости:

Возможность	Зависимость
Разбор CSV-журналов PostgreSQL	`Text::CSV_XS`
Запись вывода JSON	`JSON::XS`
Чтение входных файлов `.gz`, `.bz2`, `.lz4`, `.xz`, `.zip` или `.zst`	соответствующая утилита `zcat`, `bzcat`, `lz4cat`, `xz`, `unzip` или `zstdcat`

Установите поддержку JSON в Debian или Ubuntu:

$ sudo apt-get install libjson-xs-perl

В системе на базе RPM:

$ sudo yum install perl-JSON-XS

Параметр --zcat позволяет переопределить путь к программе распаковки. Если указать одну пользовательскую команду, смешивать разные форматы сжатия в одном запуске будет нельзя.

Утилита xz должна поддерживать --robot, чтобы pgBadger мог читать метаданные архива. Сжимайте журналы lz4 с параметром --content-size, чтобы pgBadger мог определить их несжатый размер.

Установка из официального архива

Загрузите архив выпуска, затем соберите и установите его стандартными средствами Perl:

$ tar xzf pgbadger-13.2.tar.gz
$ cd pgbadger-13.2
$ perl Makefile.PL
$ make
$ sudo make install

Стандартная схема site устанавливает программу как /usr/local/bin/pgbadger, а страницу руководства — как /usr/local/share/man/man1/pgbadger.1.

Для установки в стиле системного дистрибутива под /usr создайте Makefile следующим образом:

$ perl Makefile.PL INSTALLDIRS=vendor
$ make
$ sudo make install

Исходный проект также поддерживает схему INSTALLDIRS=perl. Перед установкой в управляемую систему проверьте сгенерированные пути.

Установка разрабатываемой версии

$ git clone https://github.com/darold/pgbadger.git
$ cd pgbadger
$ perl Makefile.PL
$ make
$ make test
$ sudo make install

Разрабатываемый код может содержать изменения, ещё не описанные в примечаниях к выпуску. Для воспроизводимой сборки производственного пакета предпочтительнее архив с тегом версии.

Проверка установки

$ pgbadger --version
$ pgbadger --help

Далее перейдите к справочнику командной строки и настройке журналирования PostgreSQL .

Для загрузки комментариев требуется JavaScript. Посмотреть обсуждения на GitHub.