障害挿入クエリを使用した Amazon Aurora PostgreSQL のテスト - Amazon Aurora

障害挿入クエリを使用した Amazon Aurora PostgreSQL のテスト

障害挿入クエリを使用して、Aurora PostgreSQL DB クラスターの耐障害性をテストできます。フォールト挿入クエリは、SQL コマンドとして Amazon Aurora インスタンスに発行されます。フォールト挿入クエリを使用すると、以下のイベントのシミュレートされたテストをスケジュールできます。

障害挿入クエリでクラッシュを指定すると、Aurora PostgreSQL DB インスタンスのクラッシュが強制的に実行されます。その他の障害挿入クエリでは、障害イベントのシミュレーションが実行されますが、そのイベントは発生しません。障害挿入クエリを送信すると、障害イベントのシミュレーションが発生する時間も指定されます。

Aurora レプリカのエンドポイントに接続することによって、Aurora レプリカインスタンスの 1 つに障害挿入クエリを送信できます。詳細については、「Amazon Aurora 接続管理」を参照してください。

注記

Aurora PostgreSQL の障害挿入クエリは現在、以下のバージョンでサポートされています。

  • バージョン 2.4 (PostgreSQL バージョン 10.11 と互換性あり)。

  • バージョン 3.2 (PostgreSQL バージョン 11.7 と互換性あり)。

インスタンスのクラッシュのテスト

aurora_inject_crash() 障害挿入クエリ関数を使用して、Aurora PostgreSQL インスタンスのクラッシュを強制的に発生させることができます。

この障害挿入クエリでは、フェイルオーバーが発生しません。フェイルオーバーをテストする場合、RDS コンソールで DB クラスターの [フェイルオーバー] インスタンスアクションを選択するか、AWS CLI の failover-db-cluster コマンド、または RDS API の FailoverDBCluster オペレーションを使用できます。

構文

SELECT aurora_inject_crash ('instance' | 'dispatcher' | 'node');

オプション

この障害挿入クエリでは、次のクラッシュタイプのいずれかを指定できます。

  • 'instance' Amazon Aurora インスタンスの PostgreSQL 互換データベースのクラッシュがシミュレートされます。

  • 'dispacher' Aurora DB クラスターのプライマリインスタンスにあるディスパッチャーのクラッシュがシミュレートされます。ディスパッチャー は Amazon Aurora DB クラスターのクラスターボリュームに対して更新を書き込みます。

  • 'node' PostgreSQL 互換データベースと Amazon Aurora インスタンスのディスパッチャーの両方のクラッシュがシミュレートされます。

クラッシュタイプでは大文字と小文字は区別されません。

Aurora レプリカの障害のテスト

aurora_inject_replica_failure() 障害挿入クエリ関数を使用して、Aurora レプリカの障害をシミュレートできます。

Aurora レプリカの障害は、指定した期間で、Aurora レプリカまたは DB クラスター内のすべての Aurora レプリカに対するすべてのリクエストをブロックします。指定した時間が終了すると、影響を受けた Aurora レプリカは自動的にプライマリインスタンスと同期されます。

構文

SELECT aurora_inject_replica_failure( percentage_of_failure, quantity, 'replica_name' );

オプション

この障害挿入クエリでは、以下のパラメータを使用します。

  • percentage_of_failure 障害イベントの発生時にブロックするリクエストの割合。この値は 0~100 の倍精度にすることができます。0 を指定すると、リクエストはブロックされません。100 を指定する場合、すべてのリクエストがブロックされます。

  • quantity Aurora レプリカの障害をシミュレートする時間。時間は秒単位で示されます。たとえば、値が 20 の場合、シミュレーションは 20 秒間実行されます。

    注記

    Aurora レプリカの障害イベントの時間を指定するときには注意が必要です。指定する時間が長すぎ、障害イベントの発生時に書き込みインスタンスが大量のデータを書き込んだ場合、Aurora DB クラスターは Aurora レプリカがクラッシュしたものと見なし、レプリカを置き換える可能性があります。

  • replica_name— 障害シミュレーションを挿入する Aurora レプリカ。1 つの Aurora レプリカの障害をシミュレートするには Aurora レプリカの名前を指定します。DB クラスターのすべての Aurora レプリカの障害をシミュレートするには、空の文字列を指定します。

    レプリカ名を識別するには、aurora_replica_status() 関数の server_id 列を参照してください。次に例を示します。

    postgres=> SELECT server_id FROM aurora_replica_status();

ディスクの障害のテスト

aurora_inject_disk_failure() 障害挿入クエリ関数を使用して、Aurora PostgreSQL DB クラスターのディスクの障害をシミュレートできます。

ディスク障害のシミュレーションでは、Aurora PostgreSQL DB クラスターがランダムにディスクセグメントをエラーとしてマークします。シミュレーションの実行中、これらのセグメントに対するリクエストはブロックされます。

構文

SELECT aurora_inject_disk_failure( percentage_of_failure, index, is_disk, quantity );

オプション

この障害挿入クエリでは、以下のパラメータを使用します。

  • percentage_of_failure — 障害イベントの発生時にエラーとしてマークするディスクの割合。この値は 0~100 の倍精度にすることができます。0 を指定すると、ディスクのどの部分もエラーとしてマークされません。100 を指定すると、ディスク全体がエラーとしてマークされます。

  • index — 障害イベントをシミュレートする特定の論理データブロック。利用可能なデータの論理ブロックまたはストレージノードの範囲を超えた場合は、指定できる最大インデックス値を示すエラーが表示されます。このエラーを回避するには、「Aurora DB クラスターのボリュームステータスの表示」を参照してください。

  • is_disk — 障害が論理ブロックに挿入されるのかストレージノードに挿入されるのかを示します。true を指定すると、論理ブロックに障害が挿入されます。false を指定すると、ストレージノードに障害が挿入されます。

  • quantity — Aurora レプリカの障害をシミュレートする時間。時間は秒単位で示されます。たとえば、値が 20 の場合、シミュレーションは 20 秒間実行されます。

ディスクの輻輳のテスト

aurora_inject_disk_congestion() 障害挿入クエリ関数を使用して、Aurora PostgreSQL DB クラスターのディスクの障害をシミュレートできます。

ディスク輻輳のシミュレーションでは、Aurora PostgreSQL DB クラスターがランダムにディスクセグメントを輻輳としてマークします。これらのセグメントに対するリクエストは、シミュレーションの実行中、指定した最小遅延値と最大遅延値の間で遅延します。

構文

SELECT aurora_inject_disk_congestion( percentage_of_failure, index, is_disk, quantity, minimum, maximum );

オプション

この障害挿入クエリでは、以下のパラメータを使用します。

  • percentage_of_failure 障害イベントの発生時に輻輳としてマークするディスクの割合。これは 0~100 の間の倍精度値です。0 を指定すると、ディスクのどの部分も輻輳としてマークされません。100 を指定すると、ディスク全体が輻輳としてマークされます。

  • index 障害イベントのシミュレーションに使用する特定の論理データブロックまたはストレージノード。

    利用可能なデータの論理ブロックまたはストレージノードの範囲を超えた場合は、指定できる最大インデックス値を示すエラーが表示されます。このエラーを回避するには、「Aurora DB クラスターのボリュームステータスの表示」を参照してください。

  • is_disk 障害が論理ブロックに挿入されるのかストレージノードに挿入されるのかを示します。true を指定すると、論理ブロックに障害が挿入されます。false を指定すると、ストレージノードに障害が挿入されます。

  • quantity Aurora レプリカの障害をシミュレートする時間。時間は秒単位で示されます。たとえば、値が 20 の場合、シミュレーションは 20 秒間実行されます。

  • minimum および maximum 輻輳による遅延の最小値と最大値をミリ秒単位で指定します。シミュレーションを実行する間、輻輳としてマークされたディスクセグメントでは、最小値と最大値の間の範囲でランダムな遅延が発生します。