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

# CloudWatch를 사용하여 Amazon Kinesis Video Streams Edge 에이전트 모니터링
<a name="monitoring-edge-cloudwatch"></a>

원시 데이터를 수집하여 읽기 가능하며 실시간에 가까운 지표로 처리하는 Amazon CloudWatch를 사용하여 Amazon Amazon Kinesis Video Streams Edge Agent를 모니터링할 수 있습니다. 이러한 통계는 15개월 동안 기록됩니다. 이 기록 정보를 통해 웹 애플리케이션 또는 Amazon Kinesis Video Streams Edge Agent 서비스가 어떻게 실행되고 있는지 더 잘 파악할 수 있습니다.

지표를 보려면 다음을 수행합니다.

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.

1. 왼쪽 탐색의 **지표**에서 **모든 지표를** 선택합니다.

1. **찾아보**기 탭을 선택한 다음 **EdgeRuntimeAgent** 사용자 지정 네임스페이스를 선택합니다.

Amazon Kinesis Video Streams Edge Agent는 네임스페이스 아래에 `EdgeRuntimeAgent`다음 지표를 게시합니다.

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

## Amazon Kinesis Video Streams Edge 에이전트에 대한 CloudWatch 지표 지침
<a name="monitoring-edge-qa"></a>

CloudWatch 지표는 다음 질문에 대한 답변을 찾는 데 유용할 수 있습니다.

**Topics**
+ [Amazon Kinesis Video Streams Edge 에이전트에 기록할 공간이 충분합니까?](#monitoring-edge-space)
+ [Amazon Kinesis Video Streams Edge 에이전트가 활성 상태입니까?](#monitoring-edge-alive)
+ [비정상 작업이 있나요?](#monitoring-edge-unhealthy)
+ [외부 개입이 필요한 작업이 있나요?](#monitoring-edge-intervention)

### Amazon Kinesis Video Streams Edge 에이전트에 기록할 공간이 충분합니까?
<a name="monitoring-edge-space"></a>

**관련 지표:** `PercentageSpaceUsed`

**작업:** 작업이 필요하지 않습니다.

### Amazon Kinesis Video Streams Edge 에이전트가 활성 상태입니까?
<a name="monitoring-edge-alive"></a>

**관련 지표:** `Alive`

**작업:** 언제든지이 지표 수신을 중지하면 Amazon Kinesis Video Streams Edge 에이전트가 다음 중 **하나 이상을** 발견했음을 의미합니다.
+ 애플리케이션 런타임 문제: 메모리 또는 기타 리소스 제약 조건, 버그 등
+ 종료 시 에이전트가 실행 중이거나, 충돌했거나, 종료된 AWS IoT 디바이스
+  AWS IoT 디바이스에 네트워크 연결이 없습니다.

### 비정상 작업이 있나요?
<a name="monitoring-edge-unhealthy"></a>

**관련 측정치:**
+ `RecordJobs.UnhealthyJobCount`
+ `UploadJobs.UnhealthyJobCount`

**작업:** 로그를 검사하고 `FatalError` 지표를 찾습니다.
+ `FatalError` 지표**가** 있는 경우 치명적인 오류가 발생하여 작업을 수동으로 다시 시작해야 합니다. 를 사용하여 작업을 수동으로 다시 시작하기 전에 로그`StartEdgeConfigurationUpdate`를 검사하고 문제를 해결합니다.
+ `FatalError` 지표**가** 없으면 일시적인(치명적이지 않은) 오류가 발생하여 Amazon Kinesis Video Streams Edge Agent가 작업을 재시도하는 중입니다.

**참고**  
에이전트가 치명적으로 잘못된 작업을 다시 시도하도록 하려면를 사용합니다[StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md).

### 외부 개입이 필요한 작업이 있나요?
<a name="monitoring-edge-intervention"></a>

**관련 측정치:**
+ `PercentageSpaceUsed` -이 값이 특정 값을 초과하면 레코드 작업이 일시 중지되고 스페이스를 사용할 수 있는 경우에만 재개됩니다(미디어 보존 기간이 초과됨). 상위 로 업데이트된 구성을 전송`MaxLocalMediaSizeInMB`하여 작업을 즉시 업데이트할 수 있습니다.
+ `RecordJob.FatalError` / `UploadJob.FatalError` - 에이전트의 로그를 조사하고 작업을 재개하기 위해 구성을 다시 전송합니다.

**작업:** 구성으로 API를 호출하여이 문제가 발생하는 작업을 다시 시작합니다.