기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon CloudWatch를 사용하여 모니터링
Amazon CloudWatch는 AWS 리소스와 실행 중인 애플리케이션을 AWS 거의 실시간으로 모니터링합니다. 원시 데이터를 수집하여 지표를 거의 실시간으로 의미 있는 통계로 처리하는 CloudWatch를 통해 Amazon Location 리소스를 모니터링할 수 있습니다. Amazon CloudWatch 콘솔에서 최대 15개월 동안의 기록 정보를 보거나 확인할 지표를 검색하여 애플리케이션 또는 서비스가 어떻게 수행되고 있는지 더 자세히 알아볼 수 있습니다. 또한 임계값 지정에 의한 경보를 설정하여 해당 임계값이 충족될 때 알림을 전송하거나 조치를 취할 수 있습니다.
자세한 정보는 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.
**Topics**
+ [Amazon Location Service 지표 및 차원](#metrics-exported-to-cloudwatch)
+ [Amazon Location Service 지표 보기](#view-metrics)
+ [Amazon Location Service 지표에 대한 CloudWatch 경보 생성](#create-alarms)
+ [CloudWatch를 사용하여 할당량 대비 사용량 모니터링](#alarms-on-quotas)
+ [Amazon Location Service에 대한 CloudWatch 지표 예제](#example-alarms)
## Amazon Location Service 지표 및 차원
지표는 CloudWatch로 내보내는 시간별 데이터 포인트입니다. 차원이란 지표를 식별하는 이름/값 쌍을 말합니다. 자세한 내용은 Amazon CloudWatch 사용 설명서의 [CloudWatch 지표 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)과 [CloudWatch 차원](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)을 참조하세요.
**참고**
Amazon Location Service의 분산 아키텍처로 인해 결과는 거의 비슷합니다. 대부분의 경우 개수는 전송 중인 실제 API 작업 수에 가까워야 합니다.
### Amazon Location Service 지표
다음은 Amazon Location Service가 `AWS/Location` 네임스페이스의 CloudWatch로 내보내는 지표입니다.
| 지표 | 설명 | 측정 기준 |
| --- | --- | --- |
| `CallCount` | 지정된 API 엔드포인트에 대한 호출 횟수. 유효한 통계: Sum 단위: 개 | OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName OperationName, OperationVersion OperationName, OperationVersion, ResourceName ApiKeyName, OperationName, OperationVersion ApiKeyName, OperationName, OperationVersion, ResourceName |
| `ErrorCount` | 지정된 API 엔드포인트에 대한 호출의 오류 응답 횟수. 유효한 통계: Sum 단위: 개 | OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName |
| `SuccessCount` | 지정된 API 엔드포인트에 대한 성공적인 호출 횟수. 유효한 통계: Sum 단위: 개 | OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName |
| `CallLatency` | 지정된 API 엔드포인트에 대한 호출이 이루어졌을 때 작업이 응답을 처리하고 반환하는 데 걸리는 시간. 유효한 통계: Average 단위: 밀리초 | OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName |
### 지표의 Amazon Location Service 차원
아래 표의 차원을 사용하여 Amazon Location Service 지표를 필터링할 수 있습니다.
| 차원 | 설명 |
| --- | --- |
| OperationName | 지정된 작업 이름으로 API 작업에 대한 Amazon Location 지표를 필터링합니다. |
| OperationName, ResourceName | 지정된 작업 이름 및 리소스 이름으로 API 작업에 대한 Amazon Location 지표를 필터링합니다. |
| ApiKeyName, OperationName | 지정된 작업 이름 및 지정된 API 키 이름을 사용하여 API 작업에 대한 Amazon Location 지표를 필터링합니다. |
| ApiKeyName, OperationName, ResourceName | 지정된 작업 이름, 리소스 이름 및 지정된 API 키 이름을 사용하여 API 작업에 대한 Amazon Location 지표를 필터링합니다. |
| OperationName, OperationVersion | 지정된 작업 이름으로 API 작업에 대한 Amazon Location 지표를 필터링합니다. Amazon Location Service 독립형 Maps, Places 및 Routes는 이 차원으로 지표를 내보냅니다. |
| OperationName, OperationVersion, ResourceName | 지정된 작업 이름, 버전 및 Amazon Location 리소스 이름으로 API 작업에 대한 Amazon Location 지표를 필터링합니다. Amazon Location 독립형 Maps, Places 및 Routes는 이 차원으로 지표를 내보냅니다. |
| ApiKeyName, OperationName, OperationVersion | 지정된 작업 이름, 버전 및 지정된 API 키 이름을 사용하여 API 작업에 대한 Amazon Location 지표를 필터링합니다. Amazon Location 독립형 Maps, Places 및 Routes는 이 차원으로 지표를 내보냅니다. |
| ApiKeyName, OperationName, OperationVersion, ResourceName | 지정된 작업 이름, 버전, 리소스 이름 및 지정된 API 키 이름을 사용하여 API 작업에 대한 Amazon Location 지표를 필터링합니다. Amazon Location 독립형 Maps, Places 및 Routes는 이 차원으로 지표를 내보냅니다. |
## Amazon Location Service 지표 보기
Amazon CloudWatch 콘솔에서 또는 Amazon CloudWatch API를 사용하여 Amazon Location Service에 대한 지표를 볼 수 있습니다.
**CloudWatch 콘솔을 사용하여 지표 보기**
**Example**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **지표**를 선택합니다.
1. **모든 지표** 탭에서 **위치** 네임스페이스를 선택합니다.
1. 확인하려는 지표 유형을 선택합니다.
1. 지표를 선택하여 차트에 추가합니다.
자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [사용 가능한 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)를 참조하세요.
## Amazon Location Service 지표에 대한 CloudWatch 경보 생성
CloudWatch를 사용하여 Amazon Location Service 지표에 경보를 설정할 수 있습니다. 예를 들어, CloudWatch에서 경보를 생성하여 오류 횟수가 급증할 때마다 이메일을 보낼 수 있습니다.
다음 주제에서는 CloudWatch를 사용하여 경보를 설정하는 방법에 대한 상위 수준의 개요를 제공합니다. 구체적인 지침은 *Amazon CloudWatch 사용 설명서*의 [경보 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)을 참조하세요.
**CloudWatch 콘솔을 사용하여 경보를 설정하려면**
**Example**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **경보**를 선택합니다.
1. **경보 생성**을 선택합니다.
1. **지표 선택**을 선택합니다.
1. **모든 지표** 탭에서 **위치** 네임스페이스를 선택합니다.
1. 지표 카테고리를 선택합니다.
1. 경보를 만들려는 지표가 있는 행을 찾은 다음 이 행 옆의 확인란을 선택합니다.
1. **지표 선택**을 선택합니다.
1. **지표**에서 값을 입력합니다.
1. 경보 **조건**을 지정합니다.
1. **다음**을 선택합니다.
1. 경보 조건이 충족될 때 알림을 보내려는 경우:
+ **경보 상태 트리거**에서 알림 전송 여부를 묻는 경보 상태를 선택합니다.
+ **SNS 주제 선택**에서 **새 주제 생성**을 선택하여 Amazon Simple Notification Service(SNS) 주제를 새로 생성합니다. 주제 이름과 알림을 보낼 이메일을 입력합니다.
+ **알림 수신처**에서 알림을 보낼 추가 이메일 주소를 입력합니다.
+ **알림 추가**를 선택합니다. 이 목록은 향후 경보를 위해 필드에 저장되고 표시됩니다.
1. 완료되면 **다음**을 선택합니다.
1. 경보의 이름과 설명을 입력하고 **다음**을 선택합니다.
1. 알람 세부 정보를 확인한 후 **다음**을 선택합니다.
**참고**
새 Amazon SNS 주제를 생성할 때에는, 이메일 주소를 확인해야 알림을 보낼 수 있습니다. 이메일이 확인되지 않은 경우, 상태 변경으로 경보가 시작될 때 알림이 수신되지 않습니다.
CloudWatch 콘솔을 사용하여 경보를 설정하는 방법에 대한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [이메일을 보내는 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)을 참조하세요.
## CloudWatch를 사용하여 할당량 대비 사용량 모니터링
Amazon CloudWatch 경보를 생성하여 지정된 할당량 사용률이 구성 가능한 임계값을 초과하는 경우 알림을 받을 수 있습니다. 이를 통해 할당량 한도에 근접했을 때를 인지하고 사용량을 조정하여 비용 초과가 발생하지 않도록 하거나 필요한 경우 할당량 증가를 요청할 수 있습니다.
CloudWatch를 사용하여 할당량을 모니터링하는 방법에 대한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [Service Quotas 시각화 및 경보 설정](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)을 참조하세요.
## Amazon Location Service에 대한 CloudWatch 지표 예제
[GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) API를 사용하여 Amazon Location의 지표를 검색할 수 있습니다.
+ 예를 들어, 수치가 떨어질 때를 대비하여 이를 모니터링하고 `CallCount` 경보를 설정할 수 있습니다.
`SendDeviceLocation`의 `CallCount` 지표를 모니터링하면 추적된 자산을 한눈에 파악할 수 있습니다. `CallCount`이 하락했다면 트럭 플릿 등 추적 대상 자산이 현재 위치 전송을 중단했다는 뜻입니다. 이에 대한 경보를 설정하면 문제 발생을 알리는 데 도움이 될 수 있습니다.
+ 또 다른 예로, 수치가 급증할 때를 대비하여 이를 모니터링하고 `ErrorCount` 경보를 설정할 수 있습니다.
지오펜스를 기준으로 기기 위치를 평가하려면 트래커를 지오펜스 컬렉션과 연결해야 합니다. 지속적인 위치 업데이트가 필요한 디바이스 플릿이 있는 경우, `BatchEvaluateGeofence` 또는 `BatchPutDevicePosition`의 `CallCount`이 0으로 떨어지면 업데이트가 더 이상 진행되지 않는다는 의미입니다.
다음은 맵 리소스 생성을 위한 `CallCount` 및 `ErrorCount`에 대한 지표와 함께 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)에 대한 출력의 예입니다.
```
{
"StartTime": 1518867432,
"EndTime": 1518868032,
"MetricDataQueries": [
{
"Id": "m1",
"MetricStat": {
"Metric": {
"Namespace": "AWS/Location",
"MetricName": "CallCount",
"Dimensions": [
{
"Name": "SendDeviceLocation",
"Value": "100"
}
]
},
"Period": 300,
"Stat": "SampleCount",
"Unit": "Count"
}
},
{
"Id": "m2",
"MetricStat": {
"Metric": {
"Namespace": "AWS/Location",
"MetricName": "ErrorCount",
"Dimensions": [
{
"Name": "AssociateTrackerConsumer",
"Value": "0"
}
]
},
"Period": 1,
"Stat": "SampleCount",
"Unit": "Count"
}
}
]
}
```