
Amazon Aurora DSQL でサポートされた監査ログを S3 へ配信してみた
はじめに
2026-11-18 に Amazon Aurora DSQL の監査ログが発表されました。
クラスター内で実行した SQL 文を記録し、CloudWatch Vended Logs 経由で S3 へ構造化 JSON として配信する機能です。この記事では、東京リージョンの新規クラスターに配信を設定し、記録されるレコードの内容、S3 に届くまでの時間、設定変更が反映されるまでの挙動を確かめました。
配信の設定
監査設定を変更するには、クラスターに delivery source が存在している必要があります。そのため、配信を先に作成し、後から監査設定を追加しました。
delivery の作成
クラスターと S3 バケットは作成済みの前提で、delivery source、delivery destination、delivery の順に作成します。
REGION=ap-northeast-1
ACCOUNT_ID=111122223333
CLUSTER_ID=abcdefghijklmnopqrstuvwxyz
BUCKET=amzn-s3-demo-destination-bucket
aws logs put-delivery-source \
--name devio-audit-source \
--resource-arn "arn:aws:dsql:$REGION:$ACCOUNT_ID:cluster/$CLUSTER_ID" \
--log-type AUDIT_LOGS \
--region "$REGION"
aws logs put-delivery-destination \
--name devio-audit-destination \
--output-format json \
--delivery-destination-configuration destinationResourceArn="arn:aws:s3:::$BUCKET" \
--region "$REGION"
aws logs create-delivery \
--delivery-source-name devio-audit-source \
--delivery-destination-arn "arn:aws:logs:$REGION:$ACCOUNT_ID:delivery-destination:devio-audit-destination" \
--region "$REGION"
AWS CLI 2.41.1 では --log-type AUDIT_LOGS を指定できました。create-delivery の実行後、バケットには delivery.logs.amazonaws.com に s3:PutObject を許可するバケットポリシーが追加されていました。
レコードの項目を指定せずに create-delivery を実行すると、応答の recordFields には 23項目が並びました。実際に届いたレコードのキー数は、文のクラスと設定により 20〜23 でした。
delivery source の確認
delivery source の有無は SQL で確認できます。admin で接続して次を実行すると、delivery source がある間は has_delivery が t を返します。
SELECT * FROM sys.audit_delivery_status();
region | has_delivery
----------------+--------------
ap-northeast-1 | t
create-delivery の約15秒後に確認すると、has_delivery は t でした。
監査設定
記録する文のクラスは、ロールごとに SQL で選びます。
設定の書き方
ロール単位の値は sys.set_audit_config で、クラスター全体のベースラインは ALTER SYSTEM で設定します。
SELECT sys.set_audit_config('admin', 'dsql_audit.log', 'ddl,role,write');
SELECT sys.set_audit_config('admin', 'dsql_audit.log_rows', 'on');
ALTER SYSTEM SET dsql_audit.log = 'ddl,role,write';
SHOW dsql_audit.log;
set_audit_config の戻り値は設定した値です。ロール単位の値を設定したロールには、ベースラインではなくその値が適用されます。
ロール別の設定と記録結果
ベースラインを ddl,role,write にした状態で、次の6文を5つのロールから実行しました。
- 行を取る SELECT
- SELECT upper(...)
- リテラルの INSERT
- バインドパラメータの INSERT
- バインドパラメータの UPDATE
- DELETE
5つの DB ロールには、AWS IAM GRANT で同じ IAM ロールを対応づけました。接続時には、使う DB ロール名を指定しました。
| DB ロール | 設定 | 記録 | 内容 |
|---|---|---|---|
| role_all | all、log_parameter = on、log_rows = on | 6件 | READ 2(SELECT upper(...) も READ)、WRITE 4。バインドパラメータの INSERT の parameters は 102,role_all-bound-secret,22、リテラルの文の parameters は <none>。rows_affected あり |
| role_nostmt | all、log_statement = off、log_parameter = on | 6件 | statement_text と parameters が <not logged>。クラス、コマンド、実行主体、時刻は残る |
| role_replace | read のみ | 2件 | READ 2 のみ。WRITE は 0件で、ロールの値がベースラインを置き換えた |
| role_none | none | 0件 | |
| role_base | 個別設定なし | 4件 | ベースラインが適用され WRITE 4(INSERT 2、UPDATE 1、DELETE 1)。SELECT は 0件。parameters は <not logged>、rows_affected なし |
バインドパラメータの値を残すには log_parameter を on にします。role_all に log_parameter_max_size = 8(バイト)を追加で設定しました。バインドパラメータ付きの INSERT を 2回実行すると、長い値は 601,<long param suppressed>,1、短い値は 602,short,2 と記録されました。
ロールの作成、設定、実行した文
ここでは role_all の手順だけを示します。他のロールも同じ手順で作成し、set_audit_config に渡す値だけを表の「設定」列のとおりに変えました。orders テーブルは「レコードの例」の CREATE TABLE で作成したものです。
-- admin で実行
CREATE ROLE role_all WITH LOGIN;
GRANT SELECT, INSERT, UPDATE, DELETE ON orders TO role_all;
AWS IAM GRANT role_all TO 'arn:aws:iam::111122223333:role/my-dsql-role';
ALTER SYSTEM SET dsql_audit.log = 'ddl,role,write';
SELECT sys.set_audit_config('role_all', 'dsql_audit.log', 'all');
SELECT sys.set_audit_config('role_all', 'dsql_audit.log_parameter', 'on');
SELECT sys.set_audit_config('role_all', 'dsql_audit.log_rows', 'on');
role_all で接続して、次の6文を実行します。\bind を使うので psql から実行します(検証は psql 18.6)。
SELECT id, status FROM orders WHERE id = 1;
SELECT upper('role_all-function-call');
INSERT INTO orders VALUES (101, 'role_all-literal', 11);
INSERT INTO orders VALUES ($1, $2, $3) \bind 102 'role_all-bound-secret' 22 \g
UPDATE orders SET status = $1 WHERE id = $2 \bind 'role_all-updated' 101 \g
DELETE FROM orders WHERE id = 102;
接続時は --username で DB ロールを選びます。パスワードにはトークンを使いました。admin 以外は aws dsql generate-db-connect-auth-token で、admin は aws dsql generate-db-connect-admin-auth-token で作りました。
設定を変更できるロール
| 接続した DB ロール | 実行した文 | 結果 |
|---|---|---|
| role_base(pg_dsql_audit_admin のメンバーではない) | sys.set_audit_config、sys.reset_audit_config | permission denied for function set_audit_config、permission denied for function reset_audit_config |
| 同上 | SET dsql_audit.log = 'none'、ALTER SYSTEM SET dsql_audit.log = 'none' | どちらも permission denied to set parameter "dsql_audit.log" |
| audit_admin(pg_dsql_audit_admin を付与) | sys.set_audit_config('role_base', 'dsql_audit.log', 'all') | 成功。FUNCTION と ROLE のレコードが session_user: audit_admin で記録された |
| db_admin(pg_dsql_admin、CREATEROLE) | sys.set_audit_config、sys.reset_audit_config | どちらも permission denied。CREATE ROLE created_by_dba は成功し、ROLE クラスで記録された |
設定が反映されるまで
設定を変更しても、すぐには記録に反映されない場合がありました。
| 条件 | 変更 | 結果 |
|---|---|---|
| 新規接続(5秒間隔の SHOW) | admin に ddl,role,write を設定(01:39:34Z) | 01:40:28Z、約54秒後に新しい値を返した |
| 維持した接続(10秒ごとに INSERT を 18回、約3分) | role_none を none から write へ変更(02:21:51Z) | 18回とも成功したが、監査レコードは 0件(変更の完了後に実行した 15回も記録されなかった) |
| 変更直後から、毎回新規に接続して INSERT(18回) | 同上 | 18回とも成功し、記録は 17件。02:22:00.6Z の 1件は記録されなかった |
| 3秒間隔で新規接続(40本)し、それぞれで SHOW と INSERT を実行 | role_none を none から write へ変更(02:53:53Z) | 1〜9本目は none、10〜27本目は write、28〜40本目は none。SHOW の値と記録の有無は 40本とも一致 |
ドキュメントには、設定の変更は新規接続に適用され、反映に数分かかることがあると書かれています。実測でも、約3分維持した接続は変更の完了後も旧設定のままでした。新規接続でも、変更から約6分後に旧設定が返ることがありました。
記録の内容
レコードの例
届いたレコードは、次のコマンドで読めます。
aws s3 ls "s3://$BUCKET/AWSLogs/$ACCOUNT_ID/dsql/" --recursive
aws s3 cp "s3://$BUCKET/<object-key>" - | gunzip
オブジェクトキーは次の形でした。
AWSLogs/111122223333/dsql/ap-northeast-1/2026/11/19/01/111122223333_dsql_audit_logs_ap-northeast-1_20261119T01Z_<8桁>.log.gz
時間単位のディレクトリは、オブジェクトの書き込み時刻ではなく、レコードの event_timestamp(UTC)の時間帯で決まります。02:00:21Z に書かれたオブジェクトは 01:56 のレコードを含むため、01/ の下に入っていました。
次の2件は、DDL のレコード(CREATE TABLE)と WRITE のレコード(INSERT)です。DDL のレコードには object_type と object_name があり、WRITE のレコードにはありません。
{
"resource_arn": "arn:aws:dsql:ap-northeast-1:111122223333:cluster/abcdefghijklmnopqrstuvwxyz",
"event_timestamp": 1795052452268,
"schema_version": "1.0",
"aws_region": "ap-northeast-1",
"cluster_id": "abcdefghijklmnopqrstuvwxyz",
"type": "SESSION",
"database": "postgres",
"session_id": "k2fq6nhv3cwdmb7xsr4tyl5gpa",
"iam_principal": "AROA123456789EXAMPLE",
"iam_arn": "arn:aws:iam::111122223333:role/my-dsql-role",
"session_user": "admin",
"user_id": "15579",
"client_application": "verify-phase-a",
"transaction_id": "m7tq4xw2bhkf5zdcvn3ryg6sla",
"statement_id": 1,
"substatement_id": 1,
"class": "DDL",
"command": "CREATE TABLE",
"object_type": "TABLE",
"object_name": "public.orders",
"statement_text": "CREATE TABLE orders (id int PRIMARY KEY, status text, amount int);",
"parameters": "<not logged>",
"rows_affected": 0
}
{
"resource_arn": "arn:aws:dsql:ap-northeast-1:111122223333:cluster/abcdefghijklmnopqrstuvwxyz",
"event_timestamp": 1795052831044,
"schema_version": "1.0",
"aws_region": "ap-northeast-1",
"cluster_id": "abcdefghijklmnopqrstuvwxyz",
"type": "SESSION",
"database": "postgres",
"session_id": "c5hq2mgy4bwgdk3tsx7qnrmb4e",
"iam_principal": "AROA123456789EXAMPLE",
"iam_arn": "arn:aws:iam::111122223333:role/my-dsql-role",
"session_user": "role_all",
"user_id": "26393",
"client_application": "work-role_all",
"transaction_id": "a3kq7zr2mfxv4c6tybw5hnde4q",
"statement_id": 4,
"substatement_id": 1,
"class": "WRITE",
"command": "INSERT",
"statement_text": "INSERT INTO orders VALUES ($1, $2, $3) ",
"parameters": "102,role_all-bound-secret,22",
"rows_affected": 1
}
クラスごとの記録
| 実行した文 | クラス | コマンド | object_type / object_name |
|---|---|---|---|
| CREATE TABLE(主キーあり) | DDL(2件) | CREATE TABLE、CREATE INDEX | あり(public.orders、public.orders_pkey) |
| CREATE INDEX ASYNC、DROP INDEX | DDL | CREATE INDEX、DROP INDEX | あり(public.idx_orders_status) |
| INSERT、UPDATE、DELETE | WRITE | 同名 | なし |
| SELECT(SELECT upper(...)、SELECT 1 も) | READ | SELECT | なし |
| CREATE ROLE、GRANT(権限の付与)、GRANT ROLE(ロールの付与) | ROLE | CREATE ROLE、GRANT、GRANT ROLE | GRANT ... ON orders だけ object_type が TABLE。object_name なし |
| sys.set_audit_config の呼び出し | FUNCTION と ROLE(1回の呼び出しで各 1件) | EXECUTE、ALTER ROLE | FUNCTION は FUNCTION / sys.set_audit_config |
| ALTER SYSTEM SET dsql_audit.log | DDL | ALTER SYSTEM | なし |
| SET、BEGIN、COMMIT、ROLLBACK、SHOW | MISC | 同名 | なし |
| EXPLAIN SELECT ... | READ と MISC(2件) | SELECT、EXPLAIN | なし |
発表は記録項目に「テーブル名」を挙げていますが、object_name が入ったのは DDL と FUNCTION のレコードだけで、WRITE と READ には入りませんでした。テーブル名は statement_text から読みます。statement_text には、リテラルの文なら値を含む全文が、バインドパラメータの文なら $1 などのプレースホルダーのまま入ります。log_parameter が off のとき、parameters は <not logged> になります。
sys.set_audit_config の呼び出しは、設定に function が無くても FUNCTION クラスで記録されました。検証中に記録された FUNCTION のレコードは、すべてこの呼び出しでした。ROLLBACK したトランザクション内の INSERT も WRITE として記録されました。
実行主体の項目
同じ IAM ロールで複数の DB ロールに接続しました。iam_arn はどれも同じ ARN で、session_user には接続した DB ロールが入りました。DB ロールの区別には session_user を使います。client_application には環境変数 PGAPPNAME の値が入ります。
admin で GRANT app_user TO admin を実行すると SET LOCAL ROLE app_user を使えるようになり、その後の INSERT のレコードは、session_user が admin のままで、user_id が app_user の OID になりました。
S3 への配信
到着までの時間
固有のマーカーを入れた INSERT を実行し、S3 を 5秒間隔で確認して、SQL の開始からマーカーを含むオブジェクトの LastModified までを測りました。各行は 1回の測定です。
| 試行 | SQL 開始(UTC) | オブジェクトの LastModified | 経過 |
|---|---|---|---|
| 1 | 01:46:20.5 | 01:50:21 | 約240秒 |
| 2 | 01:51:24.1 | 01:55:23 | 約239秒 |
| 3 | 01:56:27.4 | 02:00:21 | 約234秒 |
| 4 | 02:09:40.9 | 02:15:23 | 約342秒 |
| 5 | 02:19:01.5 | 02:20:22 | 約81秒 |
| 6 | 02:46:16.9 | 02:50:22 | 約245秒 |
オブジェクトは 5分周期で書かれました。検証中に届いた 13個のオブジェクトの LastModified は、すべて 5分刻みの時刻(:00、:05 …)の 21〜25秒後で、レコードが無い周期にはオブジェクトが作られませんでした。
CloudWatch メトリクス
list-metrics で確認できた指標は 3つで、AuditLogRecordsGenerated、AuditLogRecordsByCategory(Category ディメンション)、AuditLogMeteredBytes です。名前空間は AWS/AuroraDSQL で、ClusterId ディメンションを指定します。
AuditLogRecordsGenerated は、合計もクラス別も S3 のレコード数と一致しました。AuditLogMeteredBytes は、5分刻みのすべてのデータ点で、生成件数 × 4,096 でした。
まとめ
Aurora DSQL の監査ログを、CloudWatch Vended Logs の delivery 経由で設定できることを確認しました。
従来も CloudTrail で DSQL への接続ログを記録することはできましたが、今回、監査ログがサポートされたことで、DB の操作ログを保存できるようになりました。
高いコンプライアンス要件が求められる本番 DB として DSQL を採用される場合、今回のアップデートをお試しください。








