# マルチロケーション Canary
<a name="CloudWatch_Synthetics_Canaries_MultiLocation"></a>

Amazon CloudWatch Synthetics を使用すると、単一の管理ポイントから複数の AWS リージョンで同じ Canary を同時に実行できます。これらは*マルチロケーション Canary* と呼ばれます。1 つのリージョン (*プライマリロケーション*) で Canary を作成および管理すると、CloudWatch Synthetics は選択した追加のリージョン (*レプリカロケーション*) に自動的にレプリケートします。すべての実行、メトリクス、アーティファクトはプライマリリージョンに統合されるため、世界中のアプリケーションのパフォーマンスと可用性を一元的に把握できます。

マルチロケーション Canary を使用すると、次の利点が得られます。
+ **ユーザーエクスペリエンスの一貫性の確保** – 世界中の異なる場所から Canary を実行し、すべてのユーザーに一貫性のある高品質なエクスペリエンスが提供されることを検証してください。
+ **ロケーション固有のベースラインの確立** — ネットワークレイテンシーやデータセンターの近接性などの要因により、各リージョンのパフォーマンス特性が異なる場合があります。Canary を複数のロケーションから実行すると、ロケーションごとにパフォーマンスベースラインが作成され、通常の変動と異常を区別できます。
+ **リージョンのパフォーマンス問題の特定** — パフォーマンスと可用性は、ネットワークレイテンシー、ISP スロットリング、またはリージョンの停止により、ロケーションによって大きく異なる場合があります。さまざまなグローバルロケーションからテストすると、単一のロケーションからでは明らかにならない可能性のあるリージョン固有のボトルネックを特定するのに役立ちます。
+ **サードパーティーサービスと CDN の検証** — 支払いプロセッサ、コンテンツ配信ネットワーク、広告サービスなど、サードパーティーに依存する機能がすべてのリージョンで動作していることを確認します。データを使用して、ベンダーに SLA について責任を持たせます。
+ **誤検出の削減** — 複数のロケーションから問題が検出された場合にのみアクティブ化するアラームを設定します。このアプローチにより、限定されたロケーションの一時的なネットワーク障害による不要な通知を回避できるため、チームは重大な問題に集中できます。

**マルチロケーション Canary の仕組み**  
マルチロケーション Canary は、プライマリとレプリカのモデルを使用します。プライマリリージョンの Canary は、設定の信頼できる情報源として機能します。CloudWatch Synthetics は選択したリージョンにレプリカを自動的に作成し、各レプリカは同じスクリプト、スケジュール、環境変数を使用して個別に実行されます。すべての変更オペレーション (作成、更新、開始、停止、削除) は、プライマリリージョンから実行され、レプリカに非同期的に伝播します。すべてのロケーションからの実行データはプライマリリージョンに統合されます。

**前提条件**  
マルチロケーション Canary を作成する前に、次の要件を考慮してください。
+ マルチロケーション Canary にはランタイムバージョン `syn-nodejs-puppeteer-16.0` 以降、または `syn-nodejs-playwright-7.0` 以降が必要です。
+ すべての AWS 商用リージョンで使用できます。AWS GovCloud (米国) リージョンまたは中国リージョンでは利用できません。
+ 最大 50 のレプリカロケーションを追加できます。
+ タグはレプリカリージョンにレプリケートされません。レプリカにタグを追加するには、レプリカリージョンに移動し、タグを直接追加します。
+ プライマリ Canary の環境変数は、すべてのレプリカに適用されます。
+ すべてのロケーションが同じスクリプトとスケジュールを使用します。
+ VPC 接続が必要な場合は、各レプリカに独自の VPC 設定が必要です。VPC 設定はプライマリリージョンから継承されません。
+ コストはレプリカの数に比例します。各レプリカには、スタンドアロン Canary と同じコストが発生します。

**Topics**
+ [マルチロケーション Canary のアクセス許可](CloudWatch_Synthetics_MultiLocation_Permissions.md)
+ [マルチロケーション Canary の管理](CloudWatch_Synthetics_MultiLocation_Managing.md)
+ [マルチロケーション Canary のモニタリングとトラブルシューティング](CloudWatch_Synthetics_MultiLocation_Monitoring.md)
+ [マルチロケーション Canary でのログ一元化の使用](CloudWatch_Synthetics_MultiLocation_Log_Centralization.md)