マルチロケーション Canary の管理
マルチロケーション Canary の作成
マルチロケーション Canary を作成するには、「Canary を作成する」の手順に従って、[ロケーション] で追加のリージョンを選択します。現在のリージョンがプライマリロケーションとして自動的に選択されます。
マルチロケーション Canary を作成する場合、次の要件が適用されます。
-
最大 50 のレプリカロケーションを追加できます。
-
Canary スクリプトの .zip ファイルは 50 MB を超えることはできません。
-
選択したレプリカリージョンに既に Canary 名が存在してはいけません。
-
レプリカのロケーションは、CloudWatch Synthetics 商用リージョンでサポートされている必要があります。プライマリリージョンをレプリカのロケーションとして選択することはできません。
-
マルチロケーション Canary をグループに関連付けることはできません。Canary がグループに属している場合は、レプリカのロケーションを追加する前に、すべてのグループから関連付けを解除します。
-
Canary で VPC 接続が必要な場合は、レプリカリージョンごとに VPC 設定を個別に設定する必要があります。VPC 設定はプライマリから継承されません。
-
タグはレプリカリージョンにレプリケートされません。レプリカにタグを追加するには、レプリカリージョンに移動し、タグを直接追加します。
作成後、レプリカは非同期的にプロビジョニングされます。[設定] タブの Canary の詳細ページでレプリケーションの進行状況をモニタリングできます。レプリカが InSync 状態になると、完全にプロビジョニングされ、実行されます。レプリカリージョンでレプリカ Canary を直接表示することもできます。詳細については、「レプリケーションステータス」を参照してください。
レプリカのプロビジョニングに失敗しても、プライマリ Canary は正常に作成されます。失敗したレプリカには、Inconsistent レプリケーションステータスが表示されます。Canary を更新して再試行できます。
レプリカのロケーションの追加または削除
レプリカのロケーションを追加または削除するには、プライマリリージョンから Canary を編集し、[ロケーション] で選択内容を更新します。レプリカリージョンからマルチロケーション Canary を編集することはできません。Canary 編集の詳細については、「Canary を編集または削除する」を参照してください。
レプリカのロケーションを追加または削除する場合、次の要件が適用されます。
-
レプリケーションの進行中にマルチロケーション Canary を変更することはできません。すべてのレプリカが
InSyncまたはInconsistent状態になるまで待ってから変更を加えます。詳細については、「レプリケーションステータス」を参照してください。 -
レプリカのロケーションを追加する場合は、リクエストに Canary コードを含める必要があります。
-
整合性のないレプリカを持つ Canary を更新する場合は、同じリクエストで整合性のないレプリカをすべて削除しない限り、Canary コードを含める必要があります。
-
単一のリクエストで同じロケーションを追加および削除することはできません。
-
存在しないレプリカのロケーションを削除することはできません。
マルチロケーション Canary の開始と停止
マルチロケーション Canary を開始または停止すると、アクションはプライマリ Canary とすべてのレプリカロケーションに適用されます。
マルチロケーション Canary を開始または停止する場合、次の要件が適用されます。
-
プライマリリージョンから Canary を開始または停止する必要があります。レプリカリージョンからの開始および停止オペレーションは許可されません。
-
レプリケーションの進行中にマルチロケーション Canary を開始または停止することはできません。すべてのレプリカが
InSyncまたはInconsistent状態になるまで待ってから、開始または停止します。詳細については、「レプリケーションステータス」を参照してください。 -
Canary は、開始するには
READYまたはSTOPPED状態、停止するにはRUNNING状態である必要があります。
マルチロケーション Canary の削除
マルチロケーション Canary を削除するには、まずすべてのレプリカロケーションを削除する必要があります。詳細については、「Canary を編集または削除する」を参照してください。以下の要件が適用されます。
-
プライマリリージョンから Canary を削除する必要があります。削除オペレーションはレプリカリージョンからは許可されません。
-
削除を試みる前に、すべてのレプリカが完全に削除されるのを待ちます。[設定] タブで削除の進捗状況をモニタリングできます。詳細については、「レプリケーションステータス」を参照してください。
-
Canary は、
STOPPED、READY、またはERROR状態である必要があります。Canary が実行されている場合は、まず停止します。
レプリケーションステータス
レプリケーションステータスは、レプリカとプライマリ Canary の同期状態を示します。レプリケーションのステータスは、[設定] タブの Canary 詳細ページで確認できます。
レプリカのレプリケーションステータス値は、次のいずれかです。
-
InProgress — レプリカを作成または更新中です。プライマリからの変更はレプリカに伝達されます。
-
InSync — レプリカはプライマリ Canary 設定と完全に同期されています。
-
Inconsistent — レプリカがプライマリ Canary と同期していません。これは、伝達が失敗した場合に発生する可能性があります。Canary を再度更新することで再試行できます。
プライマリ Canary の全体的な ReplicationState には、すべてのレプリカの集計状態が表示されます。InProgress のレプリカがある場合、全体的な状態は InProgress です。Inconsistent のレプリカがある場合、全体的な状態は Inconsistent です。