# 다중 위치 카나리 관리
<a name="CloudWatch_Synthetics_MultiLocation_Managing"></a>

## 다중 위치 카나리 생성
<a name="CloudWatch_Synthetics_MultiLocation_Create_Manage"></a>

다중 위치 카나리를 생성하려면 [canary 생성](CloudWatch_Synthetics_Canaries_Create.md)의 단계에 따라 **위치**에서 추가 리전을 선택합니다. 현재 리전이 기본 위치로 자동으로 선택됩니다.

다중 위치 카나리를 생성할 때 다음 요구 사항이 적용됩니다.
+ 최대 50개의 복제본 위치를 추가할 수 있습니다.
+ 카나리 스크립트 .zip 파일은 50MB를 초과할 수 없습니다.
+ 카나리 이름은 선택한 복제본 리전에 아직 존재하지 않아야 합니다.
+ 복제본 위치는 CloudWatch Synthetics 상용 리전에서 지원되어야 합니다. 기본 리전은 복제본 위치로 선택할 수 없습니다.
+ 다중 위치 카나리는 그룹과 연결할 수 없습니다. 카나리가 그룹에 속하는 경우 복제본 위치를 추가하기 전에 모든 그룹에서 연결을 해제합니다.
+ 카나리에 VPC 연결이 필요한 경우 각 복제본 리전에 대해 VPC 설정을 별도로 구성해야 합니다. VPC 설정은 기본 카나리에서 상속되지 않습니다.
+ 태그는 복제본 리전에 복제되지 않습니다. 복제본에 태그를 추가하려면 복제본 리전으로 이동하여 태그를 직접 추가합니다.

생성 후 복제본은 비동기적으로 프로비저닝됩니다. **구성** 탭의 카나리 세부 정보 페이지에서 복제 진행 상황을 모니터링할 수 있습니다. 복제본이 `InSync` 상태에 도달하면 완전히 프로비저닝되고 실행됩니다. 복제본 카나리는 복제본 리전에서 직접 볼 수도 있습니다. 자세한 내용은 [복제 상태](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage) 섹션을 참조하세요.

복제본을 프로비저닝하지 못하면 기본 카나리가 여전히 성공적으로 생성됩니다. 실패한 복제본은 `Inconsistent` 복제 상태를 표시합니다. 카나리를 업데이트하여 재시도할 수 있습니다.

## 복제본 위치 추가 또는 제거
<a name="CloudWatch_Synthetics_MultiLocation_Update_Manage"></a>

복제본 위치를 추가하거나 제거하려면 기본 리전에서 카나리를 편집하고 **위치**에서 선택을 업데이트합니다. 복제본 리전에서는 다중 위치 카나리를 편집할 수 없습니다. 카나리 편집에 대한 자세한 내용은 [canary 편집 또는 삭제](synthetics_canaries_deletion.md) 섹션을 참조하세요

복제본 위치를 추가하거나 제거할 때 다음 요구 사항이 적용됩니다.
+ 복제가 진행되는 동안에는 다중 위치 카나리를 수정할 수 없습니다. 모든 복제본이 `InSync` 또는 `Inconsistent` 상태에 도달할 때까지 기다렸다가 변경합니다. 자세한 내용은 [복제 상태](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage) 섹션을 참조하세요.
+ 복제본 위치를 추가할 때 요청에 카나리 코드를 포함해야 합니다.
+ 복제본이 일관되지 않은 카나리를 업데이트할 때는 동일한 요청에서 일관되지 않은 복제본을 모두 제거하지 않는 한 카나리 코드를 포함해야 합니다.
+ 단일 요청에서 동일한 위치를 추가하거나 제거할 수 없습니다.
+ 존재하지 않는 복제본 위치는 제거할 수 없습니다.

## 다중 위치 카나리 시작 및 중지
<a name="CloudWatch_Synthetics_MultiLocation_StartStop_Manage"></a>

다중 위치 카나리를 시작하거나 중지하면 작업이 기본 카나리 및 모든 복제본 위치에 적용됩니다.

다중 위치 카나리를 시작하거나 중지하면 다음 요구 사항이 적용됩니다.
+ 기본 리전에서 카나리를 시작하거나 중지해야 합니다. 복제본 리전에서는 시작 및 중지 작업이 허용되지 않습니다.
+ 복제가 진행되는 동안에는 다중 위치 카나리를 시작하거나 중지할 수 없습니다. 시작 또는 중지하기 전에 모든 복제본이 `InSync` 또는 `Inconsistent` 상태에 도달할 때까지 기다립니다. 자세한 내용은 [복제 상태](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage) 섹션을 참조하세요.
+ 카나리는 시작하려면 `READY` 또는 `STOPPED` 상태이거나 중지하려면 `RUNNING` 상태여야 합니다.

## 다중 위치 카나리 삭제
<a name="CloudWatch_Synthetics_MultiLocation_Delete_Manage"></a>

다중 위치 카나리를 삭제하려면 먼저 모든 복제본 위치를 제거해야 합니다. 자세한 내용은 [canary 편집 또는 삭제](synthetics_canaries_deletion.md) 섹션을 참조하세요. 적용되는 요구 사항은 다음과 같습니다.
+ 기본 리전에서 카나리를 삭제해야 합니다. 복제본 리전에서는 삭제 작업이 허용되지 않습니다.
+ 삭제를 시도하기 전에 모든 복제본이 완전히 제거될 때까지 기다립니다. **구성** 탭에서 제거 진행 과정을 모니터링할 수 있습니다. 자세한 내용은 [복제 상태](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage) 섹션을 참조하세요.
+ 카나리는 `STOPPED`, `READY` 또는 `ERROR` 상태여야 합니다. 카나리가 실행 중인 경우 먼저 중지합니다.

## 복제 상태
<a name="CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage"></a>

복제 상태는 복제본과 기본 카나리의 동기화 상태를 나타냅니다. **구성** 탭의 카나리 세부 정보 페이지에서 복제 상태를 볼 수 있습니다.

복제본에는 다음과 같은 복제 상태 값이 포함될 수 있습니다.
+ **진행 중** - 복제본이 생성 또는 업데이트 중입니다. 기본 카나리의 변경 사항이 복제본으로 전파되고 있습니다.
+ **InSync** - 복제본이 기본 카나리 구성과 완전히 동기화됩니다.
+ **일관성 없음** - 복제본이 기본 카나리와 동기화되지 않았습니다. 이는 전파에 실패한 경우 발생할 수 있습니다. 카나리를 다시 업데이트하여 재시도할 수 있습니다.

기본 카나리의 전체 *ReplicationState*는 모든 복제본의 집계 상태를 보여줍니다. 복제본이 `InProgress`인 경우 전체 상태는 `InProgress`입니다. 복제본이 `Inconsistent`인 경우 전체 상태는 `Inconsistent`입니다.