こんにちは。PR TIMESでインターンをしている河野拓真です。
今回、Amazon RDS for PostgreSQLにpgAuditを導入し、監査ログを取得できるようにしました。
PostgreSQLの標準ログでも、log_statementを設定すれば実行されたSQLを記録できますが、「どのユーザーが、どのオブジェクトに対して、どのような操作を行ったか」を監査目的で検索・分析するには十分ではありません。pgAuditを利用すると、操作の種類や対象オブジェクトなどが決まった形式で出力されるため、インシデント発生後の調査がしやすくなります。
本記事では、pgAuditを導入した背景、PostgreSQL標準ログとの違い、監査対象の設計、ログ量やストレージ、パフォーマンスへの影響について紹介します。
なお、本記事はAmazon RDS for PostgreSQLを前提としています。オンプレミス環境では設定方法が異なる場合があります。
背景
PR TIMESの本番RDSでは、これまでPostgreSQLのスロークエリログを利用し、エラーや一定時間以上かかったSQLを記録していました。一方で、監査を目的としたログは取得していませんでした。
標準ログはパフォーマンス調査には有効ですが、事後調査に利用する際には次の課題があります。
- SQL文は記録できるものの、操作種別や対象オブジェクトが監査用の独立したフィールドとして出力されない
- 複雑なSQLでは、実際にアクセスされたテーブルをログから機械的に判定しにくい
- 重要なテーブルだけを監査対象にする、といった細かな制御が難しい
インシデント発生時に「誰が、いつ、どのデータに対して、どのような操作を行ったか」を追跡できる状態にするため、pgAuditの導入を検討しました。
pgAuditとは
pgAuditは、PostgreSQLに監査ログ機能を追加するOSSの拡張機能です。実行された操作をREAD、WRITE、DDL、ROLE、MISCなどに分類し、ユーザーや操作対象、SQL文などを決まった形式でログ出力します。
pgAuditには、ユーザーや操作種別を基準に記録する「セッション監査」と、特定のテーブルなどを対象にする「オブジェクト監査」があります。要件に応じて両者を使い分けることで、必要な操作を記録しながらログ量を抑えられます。
pgAuditは監査ログを出力する機能であり、ログ自体の改ざん防止や保管を保証するものではありません。RDSからCloudWatch Logsへの転送、保存期間、アクセス制御は別途設計する必要があります。
https://github.com/pgaudit/pgaudit/blob/main/README.md
RDS for PostgreSQL データベースログファイル – Amazon Relational Database Service
PostgreSQL標準ログ と pgAudit の違い
両者は「どちらかを選ぶ」ものではなく、目的が異なるため併用します。
| PostgreSQL標準ログ | pgAudit | |
|---|---|---|
| 主な用途 | 操作ログ、スロークエリの調査 | 監査ログ |
| 出力形式 | SQL文をそのまま出力 | 決まったフィールド形式の監査ログ |
| 操作の種別 | SQL文を解析しないと判別できない | READ / WRITE / DDL / ROLE / MISC として記録される |
| 対象テーブル | ログのフィールドには残らない | オブジェクト監査なら明示的に記録される |
| 出力量の制御 | スロークエリログで実行時間による絞り込みが可能 | 実行時間による絞り込みは不可。 対象を絞るにはロールまたはテーブル単位で指定する |
pgAuditで注意が必要なのはログ量です。実行時間による絞り込みができず、対象となったクエリはすべて記録されます。セッション監査で記録するクラスを広げると、トランザクション制御などの周辺のコマンドまで記録対象になるため、監査対象の範囲によってはログ量が大きく増えることがあります。RDSではログファイルがデータと同じEBSボリューム上に置かれるため、ディスク容量への影響を事前に見積もる必要があります。
そこでpgAuditには、記録対象を絞るための方式が2つ用意されています。pgAuditログではオブジェクト監査とセッション監査という二つのログ対象を絞るための方法があります。
セッション監査・オブジェクト監査の有効化
セッション監査
セッション監査は対象とするDB操作を指定することができます。そのためには以下の手順を踏む必要があります。
- RDSのshared_preload_librariesにpgAuditを追加する
- RDSの再起動をする
- SHOW shared_preload_libraries
- 以下の内容のコードでパラメータを付け足す
pending-rebootで最初にpgauditのパラメータを追加をしてRDSの再起動をします。
resource "aws_db_instance" "main" {
identifier = "example-db"
engine = "postgres"
engine_version = "18"
parameter_group_name = aws_db_parameter_group.main.name
enabled_cloudwatch_logs_exports = ["postgresql"]
}
resource "aws_db_parameter_group" "main" {
name = "example-postgres18"
family = "postgres18"
// セッション監査で記録する操作の種類(再起動なしで反映)
parameter {
apply_method = "pending-reboot"
name = "shared_preload_libraries"
value = "pgaudit"
}
}次にpgAuditのログを有効化します。
# session audit log
parameter {
apply_method = "immediate"
name = "pgaudit.log"
value = "none" // 対象操作なし
}pgaudit.log に指定できる値と、それぞれで記録される操作は次のとおりです。
| 値 | 記録される操作 |
|---|---|
| READ | SELECT、COPY(テーブルやクエリから読み出す場合) |
| WRITE | INSERT、UPDATE、DELETE、TRUNCATE、COPY(テーブルへ書き込む場合) |
| FUNCTION | 関数の呼び出し、DOブロック |
| ROLE | GRANT、REVOKE、CREATE / ALTER / DROP ROLE など、ロールや権限に関する操作 |
| DDL | ROLEクラスに含まれるもの以外のすべてのDDL(CREATE TABLE、ALTER TABLE など) |
| MISC | DISCARD、FETCH、CHECKPOINT、VACUUM、SET などのその他のコマンド |
| MISC_SET | SET ROLE などのSETコマンド |
| ALL | 上記すべて |
| none | セッション監査のログを出力しない(既定値) |
CLIで有効化する場合は以下のリンクを参考にしてください。
modify-db-parameter-group — AWS CLI 2.37.0 Command Reference
CLIでの有効化コマンド
aws rds modify-db-parameter-group \
--db-parameter-group-name custom-param-group-name \
--parameters "ParameterName=pgaudit.log,ParameterValue=none,ApplyMethod=immediate" \
--region aws-region最後に有効化されているか確認する
-- pgaudit が起動時に読み込まれているか
SHOW shared_preload_libraries;
-- pgaudit 拡張が作成されているか
SELECT extname, extversion FROM pg_extension WHERE extname = 'pgaudit';
-- セッション監査の設定値
SHOW pgaudit.log;正しく有効化できている場合は、次のような出力になります。
shared_preload_libraries
--------------------------
rdsutils,pgaudit
(1 row)
extname | extversion
---------+------------
pgaudit | 16.0
(1 row)
pgaudit.log
-------------
none
(1 row)pgAuditの監査ログは、PostgreSQLの標準のログファイル(postgresql.log)に書き込まれます。RDSでは、このログファイルをRDSコンソールのDBインスタンスの「ログとイベント」タブから確認できます。今回は aws_db_instance で enabled_cloudwatch_logs_exports = ["postgresql"] を指定しているため、同じ内容がCloudWatch Logsのロググループ /aws/rds/instance/<DBインスタンス識別子>/postgresql にも転送されます。
CloudWatch Logsでは、Logs Insightsで AUDIT: を含む行に絞り込むと、監査ログだけを確認できます。
2026-09-17 01:20:01 UTC:10.0.1.23(54321):admin_user@mydb:[12346]:LOG: AUDIT: SESSION,1,1,DDL,CREATE TABLE,TABLE,public.example,CREATE TABLE public.example (id integer);,<not logged>オブジェクト監査
AWS RDSのpgAuditにおける「オブジェクト監査」とは、専用の監査用ロールを作成し、そのロールに権限(GRANT)を付与したテーブルなどのオブジェクトを監視・記録させる仕組みです。
こちらの有効化手順は以下の通りです。
パラメーターを追加する前に以下のクエリを実行して監査用のrds_pgauditロールを作成します。
CREATE ROLE rds_pgaudit;その後terraformのコードで以下のように実行してオブジェクト監査ができるようにします。
parameter {
apply_method = "immediate"
name = "pgaudit.role"
value = "rds_pgaudit"
}pgaudit.role を設定しただけでは、オブジェクト監査のログは出力されません。オブジェクト監査はPostgreSQLのロールと権限の仕組みを利用していて、rds_pgaudit ロールに権限を付与したテーブルへの操作だけが記録されます。
-- 記録したい操作の権限を、監査対象のテーブルに付与する
GRANT SELECT, INSERT, UPDATE, DELETE ON public.customers TO rds_pgaudit;付与した権限と記録される操作は対応していて、SELECTを付与したテーブルではSELECTが、UPDATEを付与したテーブルではUPDATEが記録されます。権限は列単位でも付与できます。rds_pgaudit は監査の判定だけに使うロールなので、このロールでログインすることはありません。
ログは以下の通りになります。
AUDIT: OBJECT,1,1,READ,SELECT,TABLE,public.customers,
SELECT id, email FROM customers WHERE id = 42;,<not logged>| 項目 | 値 | 意味 |
|---|---|---|
| 監査ログ識別子 | AUDIT: | pgAuditが出力した監査ログであること |
| 監査種別 | OBJECT | オブジェクト監査。対象テーブルなどに紐づく記録 |
| ステートメントID | 1 | 1つのSQL実行を識別する番号 |
| サブステートメントID | 1 | そのSQL内の個別操作を識別する番号 |
| 操作分類 | READ | 読み取り操作 |
| コマンド | SELECT | 実行されたSQLコマンド |
| オブジェクト種別 | TABLE | 監査対象はテーブル |
| オブジェクト名 | public.customers | 対象のスキーマ名とテーブル名 |
| SQL文 | SELECT ... | 実際に実行されたSQL |
| パラメータ | <not logged> | バインド変数の値は記録されていない |
CLIで実行する場合は以下の手順です。
aws rds modify-db-parameter-group \
--db-parameter-group-name custom-param-group-name \
--parameters "ParameterName=pgaudit.role,ParameterValue=rds_pgaudit,ApplyMethod=pending-reboot" \
--region aws-region最後に有効化されているかの確認
SHOW pgaudit.role;※ AWSのドキュメントでは ApplyMethod=pending-reboot を指定する例が紹介されていますが、pgaudit.role は動的パラメータであるため immediate を指定でき、その場合は再起動を待たずに反映されます。ただし、これは shared_preload_libraries に pgaudit が読み込まれていることが前提です。shared_preload_libraries 自体は静的パラメータなので、pgAuditを初めて有効化する際には一度だけRDSの再起動が必要になります。
modify-db-parameter-group — AWS CLI 2.36.37 Command Reference
pgAuditのログ設計
pgAuditを有効にすると、PostgreSQLが出力するログの件数と容量が増加します。そのため、最初からすべての操作を監査するのではなく、一部のテーブルから有効化し、ストレージ容量やI/Oへの影響を確認しながら対象を広げる方針としました。
今回確認したいのは、主に次の3点です。
- 監査ログによってストレージの空き容量が減りすぎないか
- ログ出力によって書き込みI/Oの負荷が増えないか
- データベース全体の性能に影響が出ていないか
ストレージ容量への影響
ストレージ容量は、CloudWatchのFreeStorageSpaceで確認します。このメトリクスは、DBインスタンスで利用できる空きストレージをバイト単位で表します。
ここでは使用率を計算するのではなく、空き容量の推移を確認します。
pgAudit有効化前後で、この減少速度がどの程度変化したかを比較します。
ただし、FreeStorageSpaceには監査ログだけでなく、テーブル、インデックス、WAL、一時ファイルなども含まれます。そのため、この値だけからpgAuditのログ容量を算出することはできません。
書き込みI/Oへの影響
pgAuditのログ出力による直接的な影響は、主に書き込み側に現れると考えられます。
そこで、次のメトリクスを確認します。
- WriteIOPS: 1秒当たりの書き込み操作回数
- WriteThroughput: 1秒当たりの書き込みデータ量
- WriteLatency: 1回の書き込みにかかった時間
- DiskQueueDepth: 処理待ちになっているI/Oの数
WriteIOPSが増えていても、WriteLatencyやDiskQueueDepthが安定していれば、すぐに性能上の問題があるとは判断できません。複数のメトリクスを組み合わせて評価します。
ReadIOPSの位置付け
ReadIOPSは、pgAuditのログ量を測るためのメトリクスではありません。
主に、比較対象期間のデータベース負荷が同程度だったかを確認するために使用します。例えば、有効化後にWriteIOPSが増えていても、同時にReadIOPSやリクエスト数も大きく増えていれば、原因はpgAuditではなくアプリケーションのアクセス増加かもしれません。
そのため、ReadIOPSはpgAuditの直接的な影響ではなく、比較条件を確認するための補助指標として扱います。
評価手順
次の手順で、監査対象を段階的に広げます。
- 有効化前の各メトリクスを一定期間記録する
- 一部のテーブルでオブジェクト監査を有効にする
- ログ保持期間以上、メトリクスを観測する
- 同じ曜日・時間帯など、負荷が近い期間を比較する
- ストレージ容量とI/O性能に問題がなければ対象を広げる
- 対象を広げるたびに同じ確認を繰り返す
比較では、一時的なピークではなく、平均値、最大値、時間ごとの傾向を確認します。
また、実際にCloudWatch Logsへ送られたログ量は、AWS/Logs 名前空間の IncomingBytes で確認できます。これはロググループへ取り込まれた非圧縮データ量です。
メトリクスフィルター、サブスクリプションフィルター、フィルターログイベント、およびライブテールのフィルターパターン構文 – Amazon CloudWatch Logs
結論として、3つのメトリクスは次のように位置付けるのが正確です。
- FreeStorageSpace: 容量の安全性
- WriteIOPS: 書き込み処理回数の変化
- ReadIOPS: 比較期間の負荷を確認する補助指標
pgAuditを導入してから気づいたこと
pgAudit導入後CloudWatchに無事監査ログが出力されるようになったのですが、一つ問題が起きました。
NewRelicにもRDSのログを転送しているので、その分の転送料がかかるようになってしまいました。
もともとPRTIMESではNewRelicにログを転送するためにCloudWatch logsのロググループからlambda関数をトリガーとしてNewRelicにpushしています。
なのでCloudWatch logs/NewRelic両方のログ量が大きくなっている形になります。
そのためlambda関数かCloudWatch logsでフィルタリングをするという選択肢をとりました。
CloudWatch LogsからNew Relicへ転送する監査ログを除外した
PR TIMESでは、CloudWatch Logsに保存されたログをLambda経由でNew Relic Logs APIへ転送しています。

pgAuditの導入後は監査ログが増加しますが、すべての監査ログをNew Relicへ転送する必要はありませんでした。一方、事後調査に備えて、監査ログ自体はCloudWatch Logsに保持する必要があります。
そこで、CloudWatch Logsのサブスクリプションフィルターを利用し、AUDITを含むログイベントをLambdaへ配送しないようにしました。
サブスクリプションフィルターは、条件に一致したログイベントだけを転送先へ配送する仕組みです。今回は除外条件としてAUDIT指定しています。フィルターパターンは大文字・小文字を区別するため、実際のpgAuditログに出力される文字列と一致していることを確認しました。
メトリクスフィルター、サブスクリプションフィルター、フィルターログイベント、およびライブテールのフィルターパターン構文 – Amazon CloudWatch Logs
# pgAuditの監査ログ(AUDITを含む行)はNew Relicへ転送しない。
# CloudWatch Logsにはフィルター適用前のログが保存されるため、
# 監査証跡そのものは失われない。
resource "aws_cloudwatch_log_subscription_filter" "newrelic_postgresql" {
name = "newrelic-postgresql"
log_group_name = "/aws/rds/instance/example/postgresql"
filter_pattern = "-AUDIT"
destination_arn = aws_lambda_function.newrelic_log_forwarder.arn
}これにより、ログの流れは次のようになります。
- Amazon RDS for PostgreSQLがログを出力する
- PostgreSQLログをCloudWatch Logsへ保存する
- サブスクリプションフィルターがAUDITを含むイベントを除外する
- それ以外のログをLambda経由でNew Relicへ転送する
フィルタリングされるのは、CloudWatch LogsからLambdaへ配送されるログです。CloudWatch Logsへの保存量は減りませんが、Lambdaの処理量とNew Relicへの転送・取り込み量を抑えられます。
まとめ
pgAuditを導入することで、これまで log_statement では得られなかった「どの種別の操作が」「どのオブジェクトに対して」行われたのかという情報を、決まった形式で監査ログに残せるようになりました。SQL文がそのまま出力されるのではなく構造化された形で記録されるため、特定の操作種別や特定のテーブルへのアクセスだけを後から抽出することができます。
一方で、pgAuditは設定次第でログ量が大きく膨らみます。スロークエリログのように実行時間で絞り込むことができず、対象となったクエリはすべて記録されるためです。RDSではログファイルがデータと同じボリューム上に置かれることもあり、導入前に保存容量と保持期間、そしてデータベースへの負荷を確認しておく必要があります。
このログ量を調整する手段は2つあります。ひとつはセッション監査とオブジェクト監査の使い分けです。セッション監査は操作の種別で、オブジェクト監査はテーブル単位で対象を絞れるため、組み合わせることで監査要件を満たしながら記録範囲を必要最小限に保てます。もうひとつはログの転送先での制御です。CloudWatch Logsには監査ログを全量保存したうえで、New Relicへの転送対象からは除外する構成にすれば、監査証跡を失うことなく転送量だけを抑えられます。
そして、導入して終わりではなく、稼働後の継続的な確認が欠かせません。FreeStorageSpaceは容量が持つかどうかを、WriteIOPSは監査ログの書き込みによってディスクへの書き込み量がどれだけ増えたかを示します。ただし、書き込み量の増加が実際にデータベースの性能に影響しているかどうかは、これらの指標だけでは判断できません。CloudWatch Database InsightsでSQLごとの負荷や待機イベントの内訳を確認し、クエリのレスポンスタイムに変化が出ていないかもあわせて見ておく必要があります。容量は数日かけて緩やかに減っていく一方、書き込み量やレスポンスタイムの変化は有効化した直後から現れます。どれか一つではなく、これらを継続的に見ていくことが大切です。

