기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon CloudWatch를 사용하여 Amazon EC2 API 요청 모니터링
원시 데이터를 수집하여 읽기 가능하며 실시간에 가까운 지표로 처리하는 Amazon CloudWatch를 통해 Amazon EC2 API 요청을 모니터링할 수 있습니다. 이러한 지표는 시간 경과에 따른 Amazon EC2 API 작업의 사용량과 결과를 추적하는 간단한 방법을 제공합니다. 이 정보를 통해 웹 애플리케이션의 성능을 더 잘 파악할 수 있으며 다양한 문제를 식별하고 진단할 수 있습니다. 특정 임곗값을 주시하다가 해당 임계값이 충족될 때 알림을 전송하거나 구체적인 조치를 취하도록 경보를 설정할 수도 있습니다.
CloudWatch에 대한 자세한 정보는 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.
**중요**
Amazon EC2 API 지표는 옵트인 기능입니다. 이 기능에 대한 액세스를 요청해야 합니다. 자세한 내용은 [Amazon EC2 API 지표 활성화](#enable-ec2-api-metrics) 단원을 참조하십시오.
**Topics**
+ [Amazon EC2 API 지표 활성화](#enable-ec2-api-metrics)
+ [Amazon EC2 API 지표 및 측정기준](#monitor-metrics_dimensions)
+ [지표 데이터 보존](#monitor-retention)
+ [자동으로 이루어지는 요청 모니터링](#throttling-metrics)
+ [결제](#monitor-billing)
+ [Amazon CloudWatch 사용](#monitor-using)
## Amazon EC2 API 지표 활성화
다음 절차에 따라 AWS 계정에 대해 이 기능에 대한 액세스를 요청합니다.
**이 기능에 대한 액세스를 요청하려면**
1. [AWS Support 센터](https://console.aws.amazon.com/support/home#/)를 엽니다.
1. **사례 생성**을 선택합니다.
1. **계정 및 결제 지원**을 선택합니다.
1. **서비스**에서 **일반 정보 및 시작하기**를 선택합니다.
1. **범주**에서 **사용 AWS 및 서비스를** 선택합니다.
1. **다음 단계: 추가 정보**를 선택합니다
1. **제목**에 **Request access to Amazon EC2 API metrics**을 입력합니다.
1. **설명**에 **Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html**를 입력합니다. 액세스가 필요한 리전도 포함합니다.
1. **다음 단계: 지금 해결하거나 AWS에 문의하기**를 선택합니다.
1. **문의하기** 탭에서 연락 시 사용하고 싶은 언어와 연락 방법을 선택합니다.
1. **제출**을 선택합니다.
## Amazon EC2 API 지표 및 측정기준
### Metrics
Amazon EC2 API 지표는 `AWS/EC2/API` 네임스페이스에 포함됩니다. 다음 표에는 Amazon EC2 API 요청에 사용할 수 있는 지표가 나열되어 있습니다.
| 지표 | 설명 |
| --- | --- |
| `ClientErrors` | 클라이언트 오류로 인해 실패한 API 요청 수입니다. 이러한 오류는 일반적으로 요청에 올바르지 않거나 잘못된 파라미터를 지정하거나, 작업 또는 리소스를 사용할 권한이 없는 사용자를 대신하여 작업 또는 리소스를 사용하는 등 클라이언트가 수행한 작업으로 인해 발생합니다. 단위: 수 |
| `RequestLimitExceeded` | 계정에서 Amazon EC2 API가 허용하는 최대 요청 속도를 초과한 횟수입니다. Amazon EC2 API 요청은 서비스 성능을 유지하는 데 도움이 되도록 스로틀링됩니다. 요청이 스로틀링되면 `Client.RequestLimitExceeded` 오류가 발생합니다. 단위: 수 |
| `AwsTriggeredRequestLimitExceeded` | 운영 문제로 인해 AWS 가 적용한 제한으로 인해 실패한 API 요청 수입니다. 이 제한이 발생하면 운영 문제로 인해 AWS 요청이 제한되었음을 나타내는 메시지와 함께 `Client.RequestLimitExceeded` 오류가 발생합니다. 이 제한은 일시적이며 운영 문제가 해결되면 자동으로 해결됩니다. 지수 백오프 및 재시도 로직을 구현하여 이러한 임시 조절을 정상적으로 처리합니다. 단위: 수 |
| `ServerErrors` | 내부 서버 오류로 인해 실패한 API 요청 수입니다. 이러한 오류는 일반적으로 AWS 서버 측 오류, 예외 또는 장애로 인해 발생합니다. 단위: 수 |
| `SuccessfulCalls` | 성공한 API 요청 수입니다. 단위: 수 |
### 측정 기준
Amazon EC2 지표 데이터는 모든 EC2 API 작업에서 필터링할 수 있습니다. 측정기준에 대한 자세한 내용은 [Amazon CloudWatch 개념](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)을 참조하세요.
## 지표 데이터 보존
Amazon EC2 API 지표는 1분 가격으로 CloudWatch로 전송됩니다. CloudWatch는 지표 데이터를 다음과 같이 유지합니다.
+ 기간이 60초(1분)로 설정된 데이터 요소들은 15일 동안 사용할 수 있습니다.
+ 300초(5분) 주기의 데이터 포인트는 63일 동안 사용할 수 있습니다.
+ 3,600초(1시간) 주기의 데이터 포인트는 455일(15개월) 동안 사용할 수 있습니다.
## 자동으로 이루어지는 요청 모니터링
AWS 서비스 연결 역할의 요청과 같이 서비스가 사용자를 대신하여 수행하는 API 요청은 API 제한 한도에 포함되지 않으며 계정의 Amazon CloudWatch로 지표를 보내지 않습니다. 이러한 요청은 CloudWatch를 사용하여 모니터링할 수 없습니다.
타사 서비스 공급자가 사용자를 대신하여 요청한 API 요청은 API 스로틀링 한도에 포함되며 계정의 Amazon CloudWatch로 지표를 전송합니다. 이러한 요청은 CloudWatch를 사용하여 모니터링할 수 있습니다.
## 결제
표준 CloudWatch 요금 및 수수료가 적용됩니다. Amazon EC2 API 지표를 사용하는 경우 추가 요금이 적용되지 않습니다. 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing/)을 참조하세요.
## Amazon CloudWatch 사용
**Contents**
+ [CloudWatch 지표 보기](#monitor-using-viewing)
+ [CloudWatch 경보 생성](#monitor-creating)
### CloudWatch 지표 보기
다음 절차를 사용하여 Amazon EC2 API 지표를 확인하세요.
**사전 조건**
계정의 Amazon EC2 API 지표에 대한 액세스를 활성화해야 합니다. 자세한 내용은 [Amazon EC2 API 지표 활성화](#enable-ec2-api-metrics) 단원을 참조하십시오.
**콘솔을 사용하여 Amazon EC2 API 지표를 보려면**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **지표**, **모든 지표**를 선택합니다.
1. **찾아보기** 탭의 **지표**에서 지표를 보려는 리전을 선택합니다.
1. **EC2** 측정치 네임스페이스를 선택합니다.
1. 지표를 보려면 **인스턴스당 지표**와 같은 지표 측정기준을 선택합니다.
**참고**
지표는 2주 동안 사용하지 않으면 숨겨집니다. 지난 2주 동안 새 데이터 포인트를 받지 못한 경우 콘솔에 더 이상 표시되지 않고, 콘솔 검색 상자에 지표 이름 또는 측정기준 이름을 입력해도 나타나지 않으며, [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) AWS CLI 명령으로 반환되지 않습니다. 이러한 지표를 검색하려면 [get-metric-data]() 또는 [get-metric-statistics]() 명령을 사용하면 됩니다.
**명령줄을 사용하여 Amazon EC2 API 메트릭을 보려면**
다음 명령 중 하나를 사용합니다.
+ [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html)(AWS CLI)
```
aws cloudwatch list-metrics --namespace "AWS/EC2/API"
```
+ [Get-CWMetricList](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-CWMetricList.html)(AWS Tools for Windows PowerShell)
```
Get-CWMetricList -Namespace "AWS/EC2/API"
```
### CloudWatch 경보 생성
경보로 인해 상태가 변경되면 Amazon SNS 메시지를 보내는 CloudWatch 경보를 생성할 수 있습니다. 경보는 지정한 기간 동안 단일 지표를 감시합니다. 경보는 기간 수에 대한 주어진 임계값과 지표 값을 비교하여 SNS 주제에 알림을 보냅니다.
예를 들어, 서버 측 오류로 인해 실패한 DescribeInstances API 요청 수를 모니터링하는 경보를 생성할 수 있습니다. 다음 경보는 DescribeInstances API 요청 실패 수가 5분 동안 서버 측 오류 10개의 임곗값에 도달하면 이메일 알림을 보냅니다.
**사전 조건**
계정의 Amazon EC2 API 지표에 대한 액세스를 활성화해야 합니다. 자세한 내용은 [Amazon EC2 API 지표 활성화](#enable-ec2-api-metrics) 단원을 참조하십시오.
**Amazon EC2 DescribeInstances API 요청 서버 오류에 대한 경보를 생성하려면**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **경보(Alarms)** **모든 경보(All Alarms)**를 선택합니다.
1. **경보 생성**을 선택하세요.
1. **지표 선택**을 선택하고 다음을 지정합니다.
1. **EC2/API**를 선택합니다.
1. **작업별 지표**를 선택합니다.
1. **ServerErrors** 지표 이름과 같은 행에 있는 **DescribeInstances** 옆의 확인란을 선택합니다.
1. **지표 선택**을 선택합니다.
1. 선택한 지표 및 통계에 대한 그래프와 기타 정보가 표시된 **Specify metric and conditions(지표 및 조건 지정)** 페이지가 나타납니다.
1. **지표**에서 다음을 지정합니다.
1. **통계**에서 **합계**를 선택합니다.
1. **기간**에 **5분**이 선택되어 있는지 확인합니다.
1. **조건**에서 다음을 지정합니다.
1. **임곗값 유형**에서 **정적**을 선택합니다.
1. **ServerErrors가 발생할 때**에서 **더 큼/같음** **>=**을 선택합니다.
1. **다음보다...**에 **10**을 입력합니다.
1. **다음**을 선택합니다.
1. **작업 구성** 페이지가 표시됩니다.
1. **알림**에서 다음을 지정합니다.
1. **경보 상태 트리거**에서 **경보**를 선택합니다.
1. **SNS 주제 선택**에서 **기존 SNS 주제 선택** 또는 **새 주제 생성**을 선택하고 알림에 필요한 필드를 작성합니다.
1. **다음**을 선택합니다.
1. **이름 및 설명 추가** 페이지가 나타납니다.
1. **경보 이름**에 경보 이름을 입력합니다. 이름은 ASCII 문자만 포함해야 합니다.
1. **경보 설명**에 경보 관련 설명을 필요에 따라 입력합니다.
1. **다음**을 선택합니다.
1. **미리 보기 및 생성** 페이지가 나타납니다. 정보가 올바른지 확인한 다음 **경보 생성**을 선택합니다.
자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)의 *Amazon CloudWatch 경보 사용*을 참조하세요.