# Документация pgBadger 13.2

> Быстрый анализ журналов PostgreSQL и PgBouncer с подробными автономными отчётами

---

Индекс LLMS: [llms.txt](/ru/llms.txt)

---

![Логотип pgBadger](/img/docs/pgbadger/logo.png "pgBadger")

**pgBadger** — быстрый автономный анализатор журналов PostgreSQL, написанный на Perl. Он читает журналы PostgreSQL или PgBouncer и формирует подробные результаты в HTML, текстовом, двоичном, JSON-формате либо в виде необработанного CSV. HTML-отчёты автономны, интерактивны, поддерживают масштабирование, и для их просмотра нужен только веб-браузер.

## Зачем нужен pgBadger {#why-pgbadger}

pgBadger рассчитан на большие журналы и повседневную эксплуатацию:

- одна программа на Perl, не требующая обязательных модулей за пределами базовой поставки Perl;
- автоматическое определение форматов ввода `stderr`, `syslog`, `csvlog`, `jsonlog`, RDS, Cloud SQL, logplex, Redshift и PgBouncer;
- непосредственное чтение локальных файлов, стандартного ввода, удалённых файлов по SSH, а также URL с HTTP, FTP или SFTP;
- поддержка сжатых входных данных gzip, bzip2, lz4, xz, zip и zstd;
- параллельный разбор одного большого файла или множества небольших файлов;
- ежедневные, еженедельные и создаваемые по запросу ежемесячные инкрементальные отчёты;
- фильтрация по времени, базе данных, пользователю, клиенту, приложению, процессу, сеансу и шаблону запроса.

## Что содержат отчёты {#report-coverage}

Набор отчётов PostgreSQL охватывает:

- общую активность и статистику запросов;
- медленные, частые, наиболее затратные по времени, ожидающие и отменённые запросы;
- временные файлы, контрольные точки, блокировки, сеансы и соединения;
- активность autovacuum и autoanalyze по таблицам;
- ошибки и события по уровню важности и классу;
- распределения по базе данных, пользователю, клиенту, приложению и типу оператора.

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

## Структура документации {#documentation-map}

Читайте руководство в следующем порядке или сразу переходите к нужной задаче через боковую панель:

1. [Загрузите и установите](/ru/docs/pgbadger/download/) pgBadger и его необязательные модули.
2. Ознакомьтесь с полным [справочником командной строки](/ru/docs/pgbadger/command-line/).
3. Настройте [журналирование PostgreSQL](/ru/docs/pgbadger/postgresql-logging/) с префиксом, пригодным для разбора.
4. Выберите подходящий режим [параллельной обработки](/ru/docs/pgbadger/parallel-processing/).
5. Безопасно создавайте [инкрементальные отчёты](/ru/docs/pgbadger/incremental-reports/).
6. Выберите [формат вывода](/ru/docs/pgbadger/output-formats/) и изучите [локальные примеры](/ru/docs/pgbadger/sample-reports/).
7. Следите за [историей выпусков](/ru/docs/pgbadger/releases/), обращайтесь за [поддержкой](/ru/docs/pgbadger/support/) и изучите [лицензию](/ru/docs/pgbadger/license/).

## Ссылки на исходный проект {#upstream-links}

- [Сайт проекта](https://pgbadger.darold.net/)
- [Исходный код](https://github.com/darold/pgbadger)
- [Выпуски](https://github.com/darold/pgbadger/releases)
- [Трекер задач](https://github.com/darold/pgbadger/issues)

---

Страницы раздела:

- [Загрузка и установка](/ru/docs/pgbadger/download/): Официальные выпуски, пакеты, требования и установка из исходного кода
- [Справочник командной строки](/ru/docs/pgbadger/command-line/): Полный синтаксис команд pgBadger, параметры, удалённый ввод, коды возврата и примеры
- [Настройка журналирования PostgreSQL](/ru/docs/pgbadger/postgresql-logging/): Настройка журналирования запросов, log_line_prefix, локали и вспомогательной статистики для pgBadger
- [Параллельная обработка](/ru/docs/pgbadger/parallel-processing/): Выбор между параллельной обработкой частей одного журнала и множества журналов
- [Инкрементальные отчёты](/ru/docs/pgbadger/incremental-reports/): Создание ежедневных и еженедельных отчётов, управление хранением, пересборка вывода и добавление месячных сводок
- [Форматы вывода](/ru/docs/pgbadger/output-formats/): Выбор вывода HTML, текста, двоичных данных, JSON или необработанного CSV и объединение промежуточных файлов
- [Примеры отчётов](/ru/docs/pgbadger/sample-reports/): Полные, содержащие только ошибки и инкрементальные отчёты pgBadger из локального снимка сайта
- [История выпусков](/ru/docs/pgbadger/releases/): Полная история изменений pgBadger с 9.x по 13.x, упорядоченная по исходному ChangeLog
- [Поддержка и участие в разработке](/ru/docs/pgbadger/support/): Сообщение об ошибках, запрос новых функций, отправка исправлений и профессиональная поддержка PostgreSQL
- [Лицензия и благодарности](/ru/docs/pgbadger/license/): Условия лицензии PostgreSQL, авторство и включённые сторонние компоненты

---

Обратные ссылки:

- [Атрибуция](/ru/attribution/)
- [Документация](/ru/docs/)