View a markdown version of this page

マルチロケーション Canary の管理 - Amazon CloudWatch

マルチロケーション 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 は、STOPPEDREADY、または ERROR 状態である必要があります。Canary が実行されている場合は、まず停止します。

レプリケーションステータス

レプリケーションステータスは、レプリカとプライマリ Canary の同期状態を示します。レプリケーションのステータスは、[設定] タブの Canary 詳細ページで確認できます。

レプリカのレプリケーションステータス値は、次のいずれかです。

  • InProgress — レプリカを作成または更新中です。プライマリからの変更はレプリカに伝達されます。

  • InSync — レプリカはプライマリ Canary 設定と完全に同期されています。

  • Inconsistent — レプリカがプライマリ Canary と同期していません。これは、伝達が失敗した場合に発生する可能性があります。Canary を再度更新することで再試行できます。

プライマリ Canary の全体的な ReplicationState には、すべてのレプリカの集計状態が表示されます。InProgress のレプリカがある場合、全体的な状態は InProgress です。Inconsistent のレプリカがある場合、全体的な状態は Inconsistent です。