# Aurora PostgreSQL のクエリ実行計画とピークメモリのモニタリング
Aurora PostgreSQL DB インスタンスのクエリ実行計画をモニタリングして、現在のデータベース負荷の原因となる実行計画を検出し、`aurora_compute_plan_id` パラメータを使用して実行計画のパフォーマンス統計を経時的に追跡できます。クエリを実行するたびに、クエリで使用される実行計画に識別子が割り当てられ、同じ計画の後続の実行でも同じ識別子が使用されます。
Aurora PostgreSQL バージョン 14.10、15.5 以降のバージョンの DB パラメータグループでは、`aurora_compute_plan_id` がデフォルトで `OFF` になっています。計画識別子を割り当てるには、パラメータグループで `aurora_compute_plan_id` を `ON` に設定します。
このプラン識別子は、異なる用途の複数のユーティリティで使用されます。
以下のバージョンから、DB インスタンスのクエリのピークメモリ使用量をモニタリングして、高いデータベースメモリ使用量の原因となっているクエリを検出できます。
+ 16.3 以降のすべてのバージョン
+ 15.7 以降のバージョン
+ 14.12 以降のバージョン
クエリが実行されるたびに、そのクエリが使用するピークメモリが追跡されます。通常、クエリは複数回実行されます。全実行回数の平均、最小、最大メモリ使用量の値をクエリごとに表示できます。
**Topics**
+ [Aurora 関数を使用したクエリ実行計画とピークメモリへのアクセス](#AuroraPostgreSQL.Monitoring.Query.Plans.Functions)
+ [Aurora PostgreSQL クエリ実行計画のパラメータリファレンス](#AuroraPostgreSQL.Monitoring.Query.Plans.Parameters)
## Aurora 関数を使用したクエリ実行計画とピークメモリへのアクセス
`aurora_compute_plan_id` では、次の関数を使用して実行計画にアクセスできます。
+ aurora\$1stat\$1activity
+ aurora\$1stat\$1plans
クエリピークメモリには、クエリ処理の開始前に割り当てられたメモリは含まれません。ピークメモリ使用量は、各クエリの計画フェーズと実行フェーズで個別に追跡され、報告されます。
![\[\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/aurora-apg-peakmemory.png)
次の関数を使用してクエリピークメモリの統計にアクセスできます。
+ aurora\$1stat\$1statements
+ aurora\$1stat\$1plans
これらの関数の詳細については、「[Aurora PostgreSQL 関数のリファレンス](Appendix.AuroraPostgreSQL.Functions.md)」を参照してください。
## Aurora PostgreSQL クエリ実行計画のパラメータリファレンス
DB パラメータグループの以下のパラメータを使用して、クエリ実行計画をモニタリングできます。
**Topics**
+ [aurora\$1compute\$1plan\$1id](#aurora.compute_plan_id)
+ [aurora\$1stat\$1plans.minutes\$1until\$1recapture](#aurora.minutes_until_recapture)
+ [aurora\$1stat\$1plans.calls\$1until\$1recapture](#aurora.calls_until_recapture)
+ [aurora\$1stat\$1plans.with\$1costs](#aurora.with_costs)
+ [aurora\$1stat\$1plans.with\$1analyze](#aurora.with_analyze)
+ [aurora\$1stat\$1plans.with\$1timing](#aurora.with_timing)
+ [aurora\$1stat\$1plans.with\$1buffers](#aurora.with_buffers)
+ [aurora\$1stat\$1plans.with\$1wal](#aurora.with_wal)
+ [aurora\$1stat\$1plans.with\$1triggers](#aurora.with_triggers)
**注記**
`aurora_stat_plans.with_*` パラメータの設定は、新しくキャプチャされた計画に対してのみ有効になります。
### aurora\$1compute\$1plan\$1id
`aurora_compute_plan_id` は、クエリの実行中に計画識別子を割り当てるかどうかを制御する設定パラメータです。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)
### aurora\$1stat\$1plans.minutes\$1until\$1recapture
計画が再キャプチャされるまでに経過する分数。デフォルトは 0 で、計画の再キャプチャが無効になります。`aurora_stat_plans.calls_until_recapture` しきい値を超えた場合、計画は再キャプチャされます。
| デフォルト | 許可される値 | 説明 |
| --- | --- | --- |
| 0 | 0-1073741823 | 計画が再キャプチャされるまでに経過する分数を設定します。 |
### aurora\$1stat\$1plans.calls\$1until\$1recapture
計画が再キャプチャされるまでの計画の呼び出し回数。デフォルトは 0 で、呼び出し回数後に計画の再キャプチャが無効になります。`aurora_stat_plans.minutes_until_recapture` しきい値を超えた場合、計画は再キャプチャされます。
| デフォルト | 許可される値 | 説明 |
| --- | --- | --- |
| 0 | 0-1073741823 | 計画が再キャプチャされるまでの計画の呼び出し回数を設定します。 |
### aurora\$1stat\$1plans.with\$1costs
推定コストを含む EXPLAIN 計画を取得します。指定できる値は、`on` および `off` です。デフォルトは `on` です。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)
### aurora\$1stat\$1plans.with\$1analyze
ANALYZE で EXPLAIN 計画を制御します。このモードは、計画が初めてキャプチャされたときにのみ使用されます。指定できる値は、`on` および `off` です。デフォルトは `off` です。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)
### aurora\$1stat\$1plans.with\$1timing
ANALYZE を使用すると、計画のタイミングが説明にキャプチャされます。デフォルトは `on` です。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)
### aurora\$1stat\$1plans.with\$1buffers
ANALYZE を使用すると、計画のバッファの使用統計が説明にキャプチャされます。デフォルトは `off` です。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)
### aurora\$1stat\$1plans.with\$1wal
ANALYZE を使用すると、計画の WAL 使用統計が説明にキャプチャされます。デフォルトは `off` です。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)
### aurora\$1stat\$1plans.with\$1triggers
計画トリガー実行統計は、`ANALYZE` の使用時に説明にキャプチャされます。デフォルトは `off` です。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)