Reference on PIG.CENTER

Примечания к выпускам pgBadger 13.x

Mon, 01 Jan 0001 00:00:00 +0000

Здесь полностью сохранена история изменений pgBadger 13.x из исходного проекта, от новых версий к старым.

v13.2 · 2025-12-29

Это выпуск pgBadger с исправлениями проблем и патчами, предложенные пользователями после предыдущего выпуска.

Исправлена нормализация, некорректно обрабатывавшая сбалансированные строки в одинарных кавычках с экранированными кавычками внутри. Спасибо Bertrand Bourgier за сообщение.
Исправлены требования к заполнителям в документации.
Исправлен случай, когда примеры строк журнала с ошибками не попадали в отчёт. Спасибо john doe за сообщение.
Исправлена возможная проблема приоритета между ! и %s. Спасибо Luca Santarelli и Philipp Trulson за сообщение.
Код pgFormatter обновлён до версии 5.9.
Добавлено действие GitHub CI для тестирования при отправке коммитов.
Исправлен разбор заполнителя %r в log_line_prefix. Спасибо nike7o0 за сообщение.
Исправлено предупреждение о неинициализированном значении. Спасибо Ales Zeleny за сообщение.
Документация по параметрам SSH для разбора журналов Postgres дополнена примерами. Спасибо Ulrich Konrad за патч.
Добавлена команда –ssh-sudo для запуска команд по SSH через sudo. Спасибо Andrew Jackson за патч.
Исправлена возможная проблема приоритета между ! и строковым eq. Спасибо Adrien Nayrat за сообщение.
Исправлен разбор статистики pgbouncer. Спасибо mrgtt за сообщение.

v13.1 · 2025-03-16

Это выпуск pgBadger с исправлениями проблем, о которых пользователи сообщили после предыдущего выпуска, и добавляет новые возможности:

Примечания к выпускам pgBadger 12.x

Mon, 01 Jan 0001 00:00:00 +0000

Здесь полностью сохранена история изменений pgBadger 12.x из исходного проекта, от новых версий к старым.

v12.4 · 2023-12-25

Это выпуск pgBadger с исправлениями проблем, о которых пользователи сообщили после предыдущего выпуска.

Исправлен отчёт pgbouncer для версии 1.21. Спасибо Ales Zeleny за патч.
Число параллельных процессов Perl больше не может превышать число файлов. Спасибо maliangzhu за сообщение.
Исправлен регрессионный тест, не работавший с версии 12.3. Спасибо ieshin за сообщение.
Исправлены случаи, когда записи LOG учитывались как записи уровня ERROR. Спасибо Matti Linnanvuori за сообщение.

v12.3 · 2023-11-27

Это выпуск pgBadger с исправлениями проблем, о которых пользователи сообщили после предыдущего выпуска. Он также добавляет новые возможности:

Примечания к выпускам pgBadger 11.x

Mon, 01 Jan 0001 00:00:00 +0000

Здесь полностью сохранена история изменений pgBadger 11.x из исходного проекта, от новых версий к старым.

v11.8 · 2022-04-08

Этот выпуск pgBadger исправляет проблемы, о которых пользователи сообщили за предыдущие три месяца, и в особенности две ошибки обнаружения новых записей журнала в инкрементальном режиме.

Исправлено обнаружение новых записей журнала по отметке времени, когда в log_line_prefix использовались миллисекунды (%m) или эпоха (%n).
Исправлено обнаружение новых записей в локальном файле без использования многопроцессной обработки.

Полный список изменений и благодарностей:

Справочник командной строки

Mon, 01 Jan 0001 00:00:00 +0000

На этой странице сохранён справочник команд, сгенерированный из зафиксированной версии исходного кода. Имена параметров и текст справки приведены дословно, чтобы их можно было непосредственно сопоставить с выводом pgbadger --help.

Использование и параметры

Использование: pgbadger [options] logfile […]

PostgreSQL log analyzer with fully detailed reports and graphs.

Аргументы:

logfile can be a single log file, a list of files, or a shell command
returning a list of files. If you want to pass log content from stdin
use - as filename. Note that input from stdin will not work with csvlog.

Параметры:

Примечания к выпускам pgBadger 10.x

Mon, 01 Jan 0001 00:00:00 +0000

Здесь полностью сохранена история изменений pgBadger 10.x из исходного проекта, от новых версий к старым.

v10.3 · 2019-02-14

Это выпуск pgBadger с исправлениями нескольких проблем автоматического определения формата журнала и ещё одну ошибку разбора журнала pgBouncer, о которых сообщили пользователи. Также добавлена новая возможность:

Параметр -o | --outfile теперь можно указывать несколько раз, чтобы одной
командой вывести результат в нескольких форматах. Например:
 pgbadger -o out.html -o out.json /log/pgsql-11.log
создаст два отчёта в форматах HTML и JSON и сохранит их в соответствующих
файлах.

Также исправлены ошибки и улучшены возможности.

Примечания к выпускам pgBadger 9.x

Mon, 01 Jan 0001 00:00:00 +0000

Здесь полностью сохранена история изменений pgBadger 9.x из исходного проекта, от новых версий к старым.

v9.2 · 2017-07-27

Этот выпуск pgBadger с исправлениями добавляет несколько новых возможностей.

Добавлен отчёт о расстоянии и оценке контрольных точек.
В форматировщик кода SQL добавлена поддержка ключевых слов AWS Redshift.
В удалённый режим добавлено автоматическое определение формата журнала, позволяющее удалённо разбирать журнал pgbouncer вместе с журналом PostgreSQL.

Также исправлены ошибки и улучшены возможности.

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

Mon, 01 Jan 0001 00:00:00 +0000

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

Формат	Обычное расширение	Оптимальное применение
HTML	`.html`	интерактивный, удобный для чтения отчёт с диаграммами
Текст	`.txt`	просмотр в терминале и простое архивирование
Двоичный	`.bin`	объединяемая промежуточная статистика и пересборка отчётов
JSON	`.json`	интеграция с другим ПО; требует `JSON::XS`
Необработанный CSV	выбранный файл вывода	построчное извлечение с `--dump-raw-csv`

HTML и текст

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

Примеры отчётов

Mon, 01 Jan 0001 00:00:00 +0000

Примеры были созданы pgBadger 11.8 в мае 2022 года. Исходные примеры хранятся на этом сайте, поэтому навигация, диаграммы, стили и сценарии отчётов доступны без обращения к серверу исходного проекта.

Пример	Что он демонстрирует	Локальная копия
Полный отчёт	Активность PostgreSQL вместе со статистикой PgBouncer	Открыть полный отчёт
Инкрементальный отчёт	Календарный индекс, еженедельное агрегирование и ежедневные страницы	Открыть индекс инкрементальных отчётов
Ошибки и события	Отчёт, ограниченный ошибками и эксплуатационными событиями	Открыть отчёт об ошибках

Полный отчёт

Полный отчёт — автономный HTML-документ. С помощью верхней панели навигации можно изучить общую статистику, запросы, сеансы, соединения, временные файлы, контрольные точки, активность autovacuum, блокировки и диаграммы, относящиеся к PgBouncer.

История выпусков

Mon, 01 Jan 0001 00:00:00 +0000

Официальный сайт публикует новости о выпусках прямо на главной странице. Эта страница заканчивается версией 12.4 и по ошибке повторяет версии 11.1–11.3 с противоречащими друг другу датами. В этой редакции канонической записью служит зафиксированный ChangeLog исходного проекта: удалены только эти повторные представления и добавлены последующие выпуски 13.x. Записи приведены полностью и в каждой серии упорядочены от новых к старым.

Серия	Включённые версии	Первый и последний выпуск	Страница
13.x	13.0–13.2	2024-12-08 – 2025-12-29	Читать о 13.x
12.x	12.0–12.4	2022-09-13 – 2023-12-25	Читать о 12.x
11.x	11.0–11.8	2019-06-25 – 2022-04-08	Читать о 11.x
10.x	10.0–10.3	2018-09-09 – 2019-02-14	Читать о 10.x
9.x	9.0–9.2	2016-09-02 – 2017-07-27	Читать о 9.x

Архивы и дополнительные файлы доступны в разделе выпусков GitHub . Даты выпусков в этом разделе относятся к истории исходного проекта, а не ко времени загрузки данного снимка документации.

Лицензия и благодарности

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger — свободное программное обеспечение с открытым исходным кодом, распространяемое по лицензии PostgreSQL. Его можно бесплатно использовать, копировать, изменять и распространять при условии сохранения уведомлений об авторских правах и лицензии.

Лицензия PostgreSQL

Permission to use, copy, modify, and distribute this software and its documentation for any purpose, without fee, and without a written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies.