Форматы вывода

pgBadger выбирает формат вывода по расширению имени файла либо по параметру -x / --extension. Укажите -o / --outfile несколько раз, чтобы создать несколько форматов из одного результата разбора.

HTML и текст

По умолчанию результат записывается в out.html:

$ pgbadger postgresql.log -o report.html

Обычно HTML включает сценарии, стили, шрифты и данные отчёта, необходимые для автономного просмотра. Параметр -X / --extra-files выносит общие JavaScript и CSS из инкрементальных отчётов; храните эти ресурсы рядом с деревом HTML.

Чтобы явно создать текстовый файл:

$ pgbadger -x text -o report.txt postgresql.log

Укажите - вместо имени выходного файла, чтобы записать поддерживаемый формат в стандартный вывод.

Двоичные промежуточные данные

Двоичный вывод отделяет разбор от представления. Создавайте почасовые приращения из одного растущего суточного журнала:

$ pgbadger --last-parsed .pgbadger_last_state \
    -o sunday/hour01.bin \
    /var/log/pgsql/postgresql-Sun.log

Объедините один или несколько двоичных файлов в новый отчёт:

$ pgbadger -o sunday.html sunday/*.bin

Если сервер создаёт отдельный файл журнала каждый час, формируйте по одному двоичному файлу на каждую ротацию, а затем при необходимости пересобирайте накопительный HTML:

$ pgbadger -o day1/hour01.bin postgresql-2026-08-15_01.log
$ pgbadger -o day1/hour02.bin postgresql-2026-08-15_02.log
$ pgbadger -o day1/hour03.bin postgresql-2026-08-15_03.log
$ pgbadger -o day1.html day1/*.bin

Храните вместе только двоичные файлы совместимых версий pgBadger. Перед обновлением каталога долгоживущих отчётов проверьте в примечаниях к выпуску совместимость инкрементального формата.

JSON

Вывод JSON предназначен для программных потребителей, например конвейеров мониторинга и отчётности:

$ pgbadger -o report.json postgresql.log

Сначала установите JSON::XS. Если размер файла и время создания вторичны, добавьте --prettify-json для удобства чтения.

Необработанный и ориентированный на запросы экспорт

Справочник команд также описывает специализированные способы экспорта:

• --dump-raw-csv разбирает журнал и записывает построчный CSV без построения отчёта;
• --csv-separator меняет разделитель необработанного CSV;
• --dump-all-queries выводит каждый запрос после подстановки параметров привязки;
• --normalized-only записывает нормализованные запросы;
• --query-numbering нумерует текстовый вывод, ориентированный на запросы.

Эти режимы могут включать SQL приложения, идентификаторы, пользователей, адреса клиентов или литеральные значения. Проверяйте результат перед передачей другим и используйте --anonymize, если для предполагаемого анализа литералы не нужны.