Amazon Aurora DSQL でサポートされた監査ログを S3 へ配信してみた

Amazon Aurora DSQL でサポートされた監査ログを S3 へ配信してみた

Amazon Aurora DSQL の監査ログを S3 へ配信し、記録される SQL 文とレコードの内容を確かめました。実行から S3 に届くまでの時間は81〜342秒(6回の測定)で、READ と WRITE のレコードにはテーブル名の項目が入りませんでした。設定変更の反映は、約6分後にも新規接続で旧設定が適用されることがありました。
2026.11.19

はじめに

2026-11-18 に Amazon Aurora DSQL の監査ログが発表されました。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/amazon-aurora-dsql-audit-logging/

クラスター内で実行した 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分後に旧設定が返ることがありました。

https://docs.aws.amazon.com/aurora-dsql/latest/userguide/audit-logging-configure.html

記録の内容

レコードの例

届いたレコードは、次のコマンドで読めます。

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 を採用される場合、今回のアップデートをお試しください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事