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

# 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`다음 지표를 게시합니다.



- ** 스트림 이름, `RecordJob`  **
  - **State:** 실행 / **설명:** 가 실행 중일 때 지속적으로 게시`RecordJob`됩니다.<br />단위: 없음.가이 상태에 있는 한 "1"이 게시`RecordJob`됩니다.
  - **State:** FatalError / **설명:** `RecordJob` 치명적인 오류가 발생할 경우 게시합니다.<br />단위: 없음.이 이벤트가 발생하면 "1"이 한 번 게시됩니다. 자세한 내용은 로그를 참조하세요. 
  - **State:** 완료됨 / **설명:** `RecordJob`가 완료되면 게시합니다.<br />단위: 없음.이 이벤트가 발생하면 "1"이 한 번 게시됩니다.

- ** 스트림 이름, `UploadJob`  **
  - **State:** 실행 / **설명:** 가 실행 중일 때 지속적으로 게시`UploadJob`합니다.<br />단위: 없음.가이 상태에 있는 한 "1"이 게시`UploadJob`됩니다.
  - **State:** FatalError / **설명:** `UploadJob` 치명적인 오류가 발생할 경우를 게시합니다.<br />단위: 없음.이 이벤트가 발생하면 "1"이 한 번 게시됩니다. 자세한 내용은 로그를 참조하세요. 
  - **State:** 완료됨 / **설명:** `UploadJob`가 완료되면 게시합니다.<br />단위: 없음.이 이벤트가 발생하면 "1"이 한 번 게시됩니다.

- ** 스트림 이름 **
  - **State:** PercentageSpaceUsed
  - **설명:** 미디어 레코딩을 위한 Amazon Kinesis Video Streams Edge Agent 구성에 할당된 총 공간 중 사용된 백분율입니다. 자세한 정보는 [LocalSizeConfig](API_LocalSizeConfig.md)을 참조하세요.<br />단위: 백분율(스케일 0\~1).

- ** 사물 이름 **
  - **State:** Alive / **설명:** 실행 중인 구성에 관계없이 Amazon Kinesis Video Streams Edge Agent에서 1분마다 게시합니다.<br />이는 Amazon Kinesis Video Streams Edge 에이전트가 활성 상태이고 구성을 수락할 준비가 되었는지 이해하는 데 사용할 수 있습니다.<br />단위: 없음. "1"은 1분마다 게시됩니다.
  - **State:** RecordJobs.HealthyJobCount / **설명:** Amazon Kinesis Video Streams Edge Agent에서 실행 및 예약된 레코드 작업의 총 수입니다.<br />단위: 개
  - **State:** UploadJobs.HealthyJobCount / **설명:** Amazon Kinesis Video Streams Edge Agent에서 실행 중인 업로드 작업과 예약된 업로드 작업의 총 수입니다.<br />단위: 개
  - **State:** RecordJobs.UnhealthyJobCount / **설명:** 현재 오류가 발생한 레코드 작업의 총 수입니다.<br />단위: 개
  - **State:** UploadJobs.UnhealthyJobCount / **설명:** 현재 오류가 발생한 업로드 작업의 총 수입니다.<br />단위: 개
  - **State:** RecordJobs.RunningJobCount / **설명:** 활발하게 실행 중인 레코드 작업의 총 수입니다.<br />단위: 개
  - **State:** UploadJobs.RunningJobCount / **설명:** 현재 실행 중인 업로드 작업의 총 수입니다.<br />단위: 개
  - **State:** RecordJobs.EdgeConfigCount / **설명:** Amazon Kinesis Video Streams Edge Agent에서 처리 중인 총 레코드 구성 수입니다.<br />단위: 개
  - **State:** UploadJobs.EdgeConfigCount / **설명:** Amazon Kinesis Video Streams Edge 에이전트에서 진행 중인 업로드 구성의 총 수입니다.<br />단위: 개



## 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를 호출하여이 문제가 발생하는 작업을 다시 시작합니다.