本文へ移動

pgBadger 13.2ドキュメント

PostgreSQLとPgBouncerのログを高速に解析し、詳細で自己完結型のレポートを生成します
pgBadgerロゴ

pgBadgerは、Perlで書かれた高速な単体動作のPostgreSQLログアナライザーです。PostgreSQLまたはPgBouncerのログを読み取り、詳細なHTML、テキスト、バイナリ、JSON、または生のCSVを出力します。HTMLレポートは自己完結型で、操作や拡大縮小が可能です。閲覧に必要なのはウェブブラウザーだけです。

pgBadgerを選ぶ理由

pgBadgerは、大きなログの解析と運用での利用を想定して設計されています。

  • 単一のPerlプログラムであり、Perlコア以外の必須モジュールはありません。
  • stderr、syslog、csvlog、jsonlog、RDS、Cloud SQL、logplex、Redshift、PgBouncerの入力を自動検出します。
  • ローカルファイル、標準入力、SSH経由のリモートファイル、HTTP・FTP・SFTPのURLを直接読み取ります。
  • gzip、bzip2、lz4、xz、zip、zstdの圧縮入力に対応します。
  • 単一の大きなファイル、または多数の小さなファイルを並列に解析します。
  • 日次、週次、および必要に応じた月次の増分レポートを生成します。
  • 時刻、データベース、ユーザー、クライアント、アプリケーション、プロセス、セッション、クエリーパターンで絞り込めます。

レポートの内容

PostgreSQLのレポートには次の内容が含まれます。

  • 全体の動作とクエリー統計。
  • 低速、高頻度、時間消費の多い、待機中、キャンセルされたクエリー。
  • 一時ファイル、チェックポイント、ロック、セッション、接続。
  • テーブルごとのautovacuumとautoanalyzeの動作。
  • 重大度と分類ごとのエラーとイベント。
  • データベース、ユーザー、クライアント、アプリケーション、ステートメント種別ごとの分布。

PgBouncerを入力とする場合は、スループット、平均クエリー実行時間、同時セッション数、接続とセッションの分布、予約プールの使用量、および頻発するエラーとイベントのレポートが加わります。

ドキュメントの構成

次の順序でマニュアルを読むか、サイドバーから目的の作業へ直接移動してください。

  1. pgBadgerとオプションモジュールをダウンロードしてインストール します。
  2. 完全なコマンドラインリファレンス を確認します。
  3. 解析可能なプレフィックスを使ってPostgreSQLのログ出力 を設定します。
  4. 適切な並列処理 モードを選択します。
  5. 増分レポート を安全に生成します。
  6. 出力形式 を選び、ローカルのサンプル を確認します。
  7. リリース履歴 、サポート 、ライセンス を確認します。

完全な pgBadger コマンド構文、オプション、リモート入力、リターン コード、および例

pgBadger用にクエリーログ、log_line_prefix、ロケール、関連する統計を設定します

単一ログを分割する並列処理と、複数ログを単位とする並列処理を使い分けます

日次・週次レポートの生成、保持期間の管理、出力の再生成、月次集計の追加を行います

HTML、テキスト、バイナリ、JSON、生のCSVから出力形式を選び、中間ファイルを統合します

ローカルサイトのスナップショットから、完全版、エラーのみ、増分のpgBadgerレポートを開きます

pgBadger 9.x から 13.x までの変更履歴(上流の ChangeLog から正規化)

バグの報告、機能要望、パッチの提供、およびPostgreSQLの専門サポートの利用

PostgreSQL のライセンス条項、著作者、およびバンドルされているサードパーティ コンポーネント