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

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

Зачем нужен 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;
• параллельный разбор одного большого файла или множества небольших файлов;
• ежедневные, еженедельные и создаваемые по запросу ежемесячные инкрементальные отчёты;
• фильтрация по времени, базе данных, пользователю, клиенту, приложению, процессу, сеансу и шаблону запроса.

Что содержат отчёты

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

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

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

Структура документации

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

1. Загрузите и установите pgBadger и его необязательные модули.
2. Ознакомьтесь с полным справочником командной строки .
3. Настройте журналирование PostgreSQL с префиксом, пригодным для разбора.
4. Выберите подходящий режим параллельной обработки .
5. Безопасно создавайте инкрементальные отчёты .
6. Выберите формат вывода и изучите локальные примеры .
7. Следите за историей выпусков , обращайтесь за поддержкой и изучите лицензию .

Ссылки на исходный проект

• Сайт проекта
• Исходный код
• Выпуски
• Трекер задач