Amazon Aurora DSQL の SQL ステートメント統計を有効にして Database Insights と PromQL で確認してみた

Amazon Aurora DSQL の SQL ステートメント統計を有効にして Database Insights と PromQL で確認してみた

update-cluster で STATEMENT_STATISTICS を指定すると、SQL ごとの所要時間、実行回数、DPU を取得できます。影響の大きな SQL を特定でき、SQL やインデックスの改善対象を見つけるのに役立ちます。Aurora DSQL の追加料金はかかりません。
2026.11.19

はじめに

2026年11月17日に、Aurora DSQL の SQL ステートメント統計(statement statistics)が発表されました。

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

この機能は、クラスターが実行した SQL ごとに実行回数、所要時間、行数、DPU を記録し、CloudWatch の OpenTelemetry(OTel)メトリクスとして出力します。今回は、稼働中のクラスター(us-west-2)で機能を有効にし、検証用テーブルに SQL を流して、PromQL、Database Insights、CloudWatch Logs で確認しました。

有効化と反映

設定と確認

update-cluster の --metric-groups に STATEMENT_STATISTICS を指定すると有効になります。

aws dsql update-cluster --identifier <クラスターID> --metric-groups '[{"metricGroup":"STATEMENT_STATISTICS"}]' --region us-west-2 --output json
{
    "status": "UPDATING"
}

get-cluster の metricGroups で設定を確認できます。

aws dsql get-cluster --identifier <クラスターID> --region us-west-2 --query '{status:status,metricGroups:metricGroups}' --output json
{
    "status": "ACTIVE",
    "metricGroups": [
        {
            "metricGroup": "STATEMENT_STATISTICS"
        }
    ]
}

反映までの時間

設定の数分後に、正規化 SQL テキストの書き込み先であるロググループ /aws/dsql/normalized-sql-text が作成され、同時に書き込みも確認できました。設定直後に SQL を実行したため、作成と書き込みが同じタイミングになっています。

統計の取得

以降の表と画面には、テーブル名に stmtstat_ を含む検証用の文だけを載せています。

検証用テーブル stmtstat_orders には9,000行を投入しました。1トランザクションで扱える行数に上限があるため、3,000行ずつ3回に分けています。

検証用テーブルの作成(01-setup.sql)
CREATE TABLE stmtstat_orders (id bigint PRIMARY KEY, customer_id int NOT NULL, status text NOT NULL, amount int NOT NULL);
INSERT INTO stmtstat_orders SELECT g, (g % 1000) + 1, CASE WHEN g % 10 = 0 THEN 'cancelled' ELSE 'paid' END, (g * 7) % 5000 FROM generate_series(1, 3000) AS g;
INSERT INTO stmtstat_orders SELECT g, (g % 1000) + 1, CASE WHEN g % 10 = 0 THEN 'cancelled' ELSE 'paid' END, (g * 7) % 5000 FROM generate_series(3001, 6000) AS g;
INSERT INTO stmtstat_orders SELECT g, (g % 1000) + 1, CASE WHEN g % 10 = 0 THEN 'cancelled' ELSE 'paid' END, (g * 7) % 5000 FROM generate_series(6001, 9000) AS g;
SELECT count(*) FROM stmtstat_orders;

PromQL

取得に使った PromQL クエリは次のとおりです。メトリクスの各データポイントの値は、直前のデータポイントからの増分です。rate() ではなく sum_over_time() で時間範囲内の値を足し、続けて query ID ごとに sum by で合算します。

topk(100, sum by ("db.query.id") (sum_over_time({"aws.dsql.query.calls", "@resource.aws.dsql.cluster_id"="<クラスターID>"}[1h])))

上のクエリの aws.dsql.query.calls を差し替えて、aws.dsql.query. で始まる10個のメトリクスをそれぞれ取得できます。

次の表は、メトリクスごとの結果を query ID で結合し、正規化 SQL テキストと並べたものです。10個のメトリクスのうち7つを示します。各値は直近1時間の合計です。

正規化 SQL calls time (s) rows scanned_rows compute_dpu read_dpu write_dpu
SELECT count(*) FROM stmtstat_orders WHERE customer_id = $0 22 0.222186 22 198161 0.200141 11.8401 0
SELECT * FROM stmtstat_orders WHERE id = $0 10 0.009784 10 10 0.008134 0.00234 0
UPDATE stmtstat_orders SET amount = amount + $0 WHERE id = $1 5 0.009116 5 5 0.008783 0.004218 0.03125
INSERT INTO stmtstat_orders SELECT g, ... 3 0.115042 9000 15 0.114245 2.11671 56.25
DELETE FROM stmtstat_orders WHERE id = $0 3 0.004036 3 3 0.003895 0.001404 0.01875

customer_id を 1 から 22 まで変えた22回の SELECT は、コメントや空白だけが違う2文を含めて1つの query ID にまとまりました。流した文は次のとおりです。

SELECT count(*) FROM stmtstat_orders WHERE customer_id = 1;
SELECT count(*) FROM stmtstat_orders WHERE customer_id = 2;
-- customer_id = 3 から 20 まで同形
/* batch-job */ SELECT count(*)   FROM stmtstat_orders WHERE customer_id = 21;
SELECT count(*) FROM stmtstat_orders WHERE customer_id = 22; -- trailing comment
PromQL を実行するスクリプト(promql-calls.sh)

PromQL は、コンソールの Query Studio のほかに、署名付きリクエストで HTTP API からも実行できます。次のスクリプトは awscurl を使い、第1引数のメトリクス名、第2引数のクラスターID、第3引数の時間範囲(省略時は 1h)でクエリを実行します。

#!/usr/bin/env bash
# usage: promql-calls.sh <metric> <cluster-id> [range]  例: promql-calls.sh aws.dsql.query.calls $CL 1h
set -euo pipefail
M="$1"; CL="$2"; RANGE="${3:-1h}"
Q="topk(100, sum by (\"db.query.id\") (sum_over_time({\"${M}\", \"@resource.aws.dsql.cluster_id\"=\"${CL}\"}[${RANGE}])))"
ENC="$(python3 -c 'import sys,urllib.parse;print("query="+urllib.parse.quote(sys.argv[1]))' "$Q")"
awscurl --service monitoring --region us-west-2 --profile "${AWS_PROFILE:-default}" \
  -X POST 'https://monitoring.us-west-2.amazonaws.com/api/v1/query' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d "$ENC"

Database Insights

CloudWatch コンソールの Database Insights でクラスターを開き、Top SQL の検索欄に stmtstat_ を入力すると、検証用の文に絞り込まれます。文を選ぶと、SQL テキストと Query ID が下部に表示されました。

Database Insights の Top SQL で stmtstat_ を絞り込み、SELECT count(*) の文を選択した画面

SQL メトリクスタブには、選択した文のチャートが11個並びます。

SELECT count(*) の文の SQL メトリクスタブ

CloudWatch Logs

PromQL の結果では、文は query ID でしか示されません。query ID に対応する正規化 SQL は、ロググループ /aws/dsql/normalized-sql-text を Logs Insights で検索すると取得できます。

fields @timestamp, queryId, normalizedText | filter queryId = '<query ID>' | dedup queryId

時間範囲は、調べたい期間の開始時刻より3時間前から取ります。実行され続けている文の正規化 SQL は、少なくとも3時間ごとに再び書き込まれるためです。ログ1件は queryId、clusterId、normalizedText を持つ JSON です。

スキャン行数とインデックス

stmtstat_orders と同じ9,000行を持つ2つのテーブル(stmtstat_idx_off、stmtstat_idx_on)を作りました。インデックスは stmtstat_idx_on の customer_id 列にだけ作成しました。

インデックスは空のテーブルに作成し、9,000行はその後に投入しています。CREATE INDEX ASYNC はインデックスを非同期に作成するため、次のクエリで完了を確かめてから検索を流しました。

SELECT * FROM sys.jobs ORDER BY 1 DESC LIMIT 3;

検索は、各テーブルに対して SELECT count(*) FROM <テーブル名> WHERE customer_id = N の N を 1 から 20 まで変えて20回流しました。さらに、customer_id = 5 の検索を EXPLAIN ANALYZE でもう1回実行しました。各テーブルの calls は21です。

比較用テーブルの作成とデータ投入
CREATE TABLE stmtstat_idx_off (id bigint PRIMARY KEY, customer_id int NOT NULL, status text NOT NULL, amount int NOT NULL);
CREATE TABLE stmtstat_idx_on  (id bigint PRIMARY KEY, customer_id int NOT NULL, status text NOT NULL, amount int NOT NULL);
CREATE INDEX ASYNC stmtstat_idx_on_cust ON stmtstat_idx_on (customer_id);
INSERT INTO stmtstat_idx_off SELECT * FROM stmtstat_orders WHERE id BETWEEN 1 AND 3000;
INSERT INTO stmtstat_idx_off SELECT * FROM stmtstat_orders WHERE id BETWEEN 3001 AND 6000;
INSERT INTO stmtstat_idx_off SELECT * FROM stmtstat_orders WHERE id BETWEEN 6001 AND 9000;
INSERT INTO stmtstat_idx_on SELECT * FROM stmtstat_orders WHERE id BETWEEN 1 AND 3000;
INSERT INTO stmtstat_idx_on SELECT * FROM stmtstat_orders WHERE id BETWEEN 3001 AND 6000;
INSERT INTO stmtstat_idx_on SELECT * FROM stmtstat_orders WHERE id BETWEEN 6001 AND 9000;
インデックス無し インデックス有り
calls 21 21
time 合計 (s) 0.194082 0.028278
scanned_rows 合計 189002 200
scanned_rows ÷ calls 約9,000.1 約9.52
read_dpu 合計 11.2489 0.01871

インデックスを作成したテーブルでは、作成していないテーブルに比べて、scanned_rows と time の合計がともに減少したことを確認できました。

記録の対象

記録される文

SELECT、INSERT、UPDATE、DELETE が記録されました。

記録されない文

次の文は、PromQL の結果と正規化 SQL テキストのログのどちらにも出ませんでした。

  • BEGIN と COMMIT
  • CREATE TABLE、CREATE INDEX ASYNC、DROP TABLE
  • SHOW application_name
  • 存在しない列を参照してエラーになった SELECT

まとめ

Aurora DSQL の SQL ステートメント統計は、update-cluster で STATEMENT_STATISTICS を指定すると有効になります。

所要時間、実行回数、DPU の面で影響の大きな SQL を特定でき、SQL やインデックスの改善対象を見つけるのに役立ちます。

ステートメント統計には CloudWatch の標準のメトリクス料金とログ料金が適用され、Aurora DSQL の追加料金はかかりません。ぜひご活用ください。

この記事をシェアする

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

関連記事