WLM クエリモニタリングルール

Amazon Redshift ワークロード管理では、クエリモニタリングルールは、WLM キューのメトリクスベースのパフォーマンスの境界を定義し、クエリがこれらの境界を超えた場合のアクションを指定します。例えば、実行時間の短いクエリ専用のキューには、60 秒以上実行されるクエリをキャンセルするルールを作成できます。デザインの不十分なクエリを追跡する目的で、ネステッドループを含むクエリを記録する別のルールを設定することができます。

ワークロード管理 (WLM) 構成の一部としてクエリモニタリングルールを定義します。1 つのキューに対して最大 25 個のルールを定義できます。ルールの総数はキュー全体で最大 25 個に制限されています。各ルールには最大 3 つの条件または述語と 1 つのアクションが含まれます。述語は、メトリクス、比較条件 (=, <, or > )、および値で構成されています。いずれかのルールのすべての述語が満たされると、ルールのアクションがトリガーされます。ルールアクションは、前述のようにログ、ホップ、中止を指定できます。

指定のキューのルールは、そのキューで実行中のクエリにのみ適用されます。ルールは他のルールに依存しません。

WLM は 10 秒ごとにメトリクスを評価します。同じ期間に複数のルールがトリガーされると、WLM は最も重大なアクションのルールを選択します。2 つのルールのアクションの重要度が同じ場合、WLM はルール名に基づいてアルファベット順にルールを実行します。アクションがホップまたは中止の場合、アクションは記録され、クエリはキューから削除されます。アクションがログ場合、キューはキューで実行されます。WLM はルールごとにクエリあたり 1 つのログアクションを開始します。キューに他のルールが含まれている場合、これらのルールは引き続き有効です。アクションがホップで、クエリが別のキューにルーティングされる場合、新しいキューのルールが適用されます。特定のクエリに対して実行されるクエリのモニタリングと追跡アクションの詳細については、ショートクエリアクセラレーション にあるサンプルコレクションを参照してください。

ルールの述語がすべて満たされると、WLM は STL_WLM_RULE_ACTION システムテーブルに行を書き込みます。さらに、Amazon Redshift は、現在実行されているクエリのクエリメトリクスを STV_QUERY_METRICS に記録します。完了したクエリのメトリクスは STL_QUERY_METRICS に保存されます。

クエリモニタリングルールの定義

WLM 構成の一部としてクエリモニタリングルールを作成します。このルールは、クラスターのパラメータグループ定義の一部として定義します。

ルールは AWS Management Consoleを使用して作成するか、JSON でプログラム的に作成できます。

クエリモニタリングルールを定義するには、次の要素を指定します。

クエリのランタイムを制限するには、WLM タイムアウトを使用する代わりにクエリモニタリングルールを作成することをお勧めします。例えば、次の JSON スニペットに示すように、max_execution_time を 50,000 ミリ秒に設定できます。

"max_execution_time": 50000

代わりに同等のクエリモニタリングルールを定義することをお勧めします。次の例は、query_execution_time を 50 秒に設定するクエリモニタリングルールを示しています。

"rules": 
[
    {
        "rule_name": "rule_query_execution",
        "predicate": [
            {
                "metric_name": "query_execution_time",
                "operator": ">",
                "value": 50
            }
        ],
        "action": "abort"
    }            
]

クエリモニタリングルールを作成または変更するステップについては、Amazon Redshift 管理ガイドの「コンソールを使用してクエリモニタリングルールを作成または変更する」および「wlm_json_configuration パラメータのプロパティ」を参照してください。

クエリモニタリングルールの詳細は次のトピックで確認できます。

Amazon Redshift のクエリモニタリングメトリクスのプロビジョニング

次のテーブルに、クエリモニタリングルールで使用されるメトリクスを説明します (これらのメトリクスは、STV_QUERY_METRICS および STL_QUERY_METRICS システムのテーブルに保存されるメトリクスとは異なります)。

指定のメトリクスについて、パフォーマンスしきい値はクエリレベルまたはセグメントレベルのいずれかで追跡されます。セグメントとステップの詳細については、「クエリプランと実行ワークフロー」を参照してください。

SVL_QUERY_METRICS ビューは、完了したクエリのメトリクスを示します。SVL_QUERY_METRICS_SUMMARY ビューは、完了したクエリのメトリクスの最大値を示します。このビューの値は、クエリのモニタリングルールを定義するしきい値を決定する際に役立ちます。

Amazon Redshift Serverless のクエリモニタリングメトリクス

次のテーブルでは、Amazon Redshift Serverless のクエリモニタリングルールで使用されるメトリクスについて説明します。

クエリモニタリングルールテンプレート

Amazon Redshift コンソールを使用してルールを追加すると、事前定義されたテンプレートからルールを作成することを選択できます。Amazon Redshift は、述語のセットを含む新しいルールを作成し、述語にデフォルト値で入力します。デフォルトのアクションはログです。述語とアクションはユースケースに合わせて変更できます。

次の表に利用可能なテンプレートの一覧を示します。

クエリのモニタリングルールのシステムテーブルとビュー

ルールの述語がすべて満たされると、WLM は STL_WLM_RULE_ACTION システムテーブルに行を書き込みます。この行には、ルールをトリガーしたクエリとその結果のアクションに関する詳細が含まれます。

さらに、Amazon Redshift では、次のシステムテーブルとビューにクエリメトリクスが記録されます。