기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon CloudWatch를 사용하여 Amazon EventBridge 스케줄러 모니터링
<a name="monitoring-cloudwatch"></a>

 원시 데이터를 수집하여 읽기 가능하며 실시간에 가까운 지표로 처리하는 CloudWatch를 통해 Amazon EventBridge 스케줄러를 모니터링할 수 있습니다. EventBridge 스케줄러는 모든 일정에 대한 지표 집합과 연결된 DLQ(Dead Letter Queue)가 있는 일정에 대한 추가 지표 세트를 내보냅니다. 일정에 맞게 [DLQ를 구성](configuring-schedule-dlq.md)하면 일정이 재시도 정책을 모두 사용했을 때 EventBridge 스케줄러가 추가 지표를 게시합니다.

 이러한 통계는 15개월간 보관되므로 기록 정보를 보고 일정에 오류가 발생하는 이유를 더 잘 파악하고 근본적인 문제를 해결할 수 있습니다. 특정 임계값을 주시하다가 해당 임계값이 충족될 때 알림을 전송하거나 조치를 취하도록 경보를 설정할 수도 있습니다. 자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하십시오.

**Topics**
+ [용어](#monitoring-cloudwatch-terms)
+ [측정 기준](#monitoring-cloudwatch-dimensions)
+ [지표 액세스](#monitoring-cloudwatch-view-metrics)
+ [메트릭 목록](#monitoring-cloudwatch-metrics-list)
+ [EventBridge Scheduler 사용량 지표](monitoring-cloudwatch-usage-metrics.md)

## 용어
<a name="monitoring-cloudwatch-terms"></a>

**네임스페이스**  
네임스페이스는 AWS 서비스의 CloudWatch 지표를 위한 컨테이너입니다. EventBridge 스케줄러의 네임스페이스는 `AWS/Scheduler`입니다.

**CloudWatch 지표**  
CloudWatch 지표는 CloudWatch에 고유한 시간 순서별 데이터 포인트 세트를 나타냅니다.

**측정 기준**  
차원은 지표의 보안 인증에 속하는 명칭/값 쌍입니다.

**단위**  
 통계에는 측정 단위가 포함되어 있습니다. EventBridge 스케줄러의 경우 단위에는 *개수*가 포함됩니다.

## 측정 기준
<a name="monitoring-cloudwatch-dimensions"></a>

이 섹션에서는 CloudWatch에서 EventBridge 스케줄러 지표에 사용되는 CloudWatch 차원 그룹화에 대해 설명합니다.


| 차원 | 설명 | 
| --- | --- | 
|  ScheduleGroup  |  CloudWatch를 사용하여 지표를 보려는 일정의 그룹입니다. 아직 그룹을 만들지 않은 경우, EventBridge 스케줄러는 사용자의 일정을 `default` 그룹과 연결합니다.  | 

## 지표 액세스
<a name="monitoring-cloudwatch-view-metrics"></a>

이 섹션에서는 CloudWatch에서 특정 EventBridge 스케줄러 일정의 성능 지표에 액세스하는 방법을 설명합니다.

**차원에 대한 성능 지표를 보려면**

1. CloudWatch 콘솔에서 [지표 페이지](https://console.aws.amazon.com/cloudwatch/home#metricsV2:graph=~())를 엽니다.

1.  AWS 리전 선택기를 사용하여 일정에 맞는 리전을 선택합니다.

1. **스케줄러** 네임스페이스를 선택합니다.

1. **모든 지표** 탭에서 차원(예: **일정 그룹 지표**)을 선택합니다. 선택한 리전에서 생성한 모든 일정에 대한 지표를 보려면 **계정 지표**를 선택합니다.

1. 차원에 대한 CloudWatch 지표를 선택합니다. 예를 들어 **InvocationAttemptCount** 또는 **InvocationDroppedCount**를 선택한 다음 **그래프 검색**을 선택합니다.

1. **그래프로 표시된 지표** 탭을 선택하여 EventBridge 스케줄러 지표의 성능 지표를 확인합니다.

## 메트릭 목록
<a name="monitoring-cloudwatch-metrics-list"></a>

다음 표에는 모든 EventBridge 스케줄러 일정에 대한 지표와 DLQ를 구성한 일정에 대한 추가 지표가 나열되어 있습니다.

### 모든 일정에 대한 지표
<a name="monitoring-cloudwatch-metrics-list-schedules"></a>


| 네임스페이스 | 지표 | 단위 | 설명 | 
| --- | --- | --- | --- | 
|  `AWS/Scheduler`  |  `InvocationAttemptCount`  |  개수  |  모든 간접 호출 시도에 대해 내보냅니다. 이 지표를 사용하여 EventBridge 스케줄러가 일정의 간접 호출을 시도하는지 확인하고 간접 호출이 계정 할당량에 가까워지는 시점을 확인할 수 있습니다.  | 
|  `AWS/Scheduler`  |  `TargetErrorCount`  |  개수  |  EventBridge 스케줄러가 대상 API를 직접적으로 호출한 후 대상이 예외를 반환할 때 내보냅니다. 이를 사용하여 대상으로의 전송이 실패하는 시점을 확인할 수 있습니다.  | 
|  `AWS/Scheduler`  |  `TargetErrorThrottledCount`  |  개수  |  대상의 API 제한으로 인해 대상 간접 호출이 실패할 때 내보냅니다. 기본 원인이 EventBridge 스케줄러에서 수행한 대상 API 제한 직접 호출인 경우 전송 실패를 진단하는 데 사용합니다.  | 
|  `AWS/Scheduler`  |  `InvocationThrottleCount`  |  개수  |  EventBridge 스케줄러가 설정한 Service Quotas를 초과하여 EventBridge 스케줄러가 대상 간접 호출을 조절할 때 내보냅니다. 이를 사용하여 간접 호출 스로틀링 제한 할당량을 초과한 시기를 확인할 수 있습니다. Service Quotas에 대한 자세한 정보는 [Amazon EventBridge 스케줄러에 대한 할당량](scheduler-quotas.md) 섹션을 참조하세요.  | 
|  `AWS/Scheduler`  |  `InvocationDroppedCount`  |  개수  |  일정의 재시도 정책이 소진된 후 EventBridge 스케줄러가 대상을 간접적으로 호출하는 시도를 중지할 때 내보냅니다. 재시도 정책에 대한 자세한 내용은 *EventBridge 스케줄러 API 참조*의 [RetryPolicy](https://docs.aws.amazon.com/scheduler/latest/APIReference/API_RetryPolicy.html)를 참조하세요.  | 

### DLQ를 사용하는 일정에 대한 지표
<a name="monitoring-cloudwatch-metrics-list-dlq"></a>

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/scheduler/latest/UserGuide/monitoring-cloudwatch.html)