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

# Amazon CloudWatch를 사용한 Kinesis Data Streams 에이전트 상태 모니터링
<a name="agent-health"></a>

에이전트는 **AWS KinesisAgent**라는 네임스페이스를 사용하여 사용자 지정 CloudWatch 지표를 게시합니다. 이러한 지표는 에이전트가 지정된 대로 Kinesis Data Streams에 데이터를 제출하고 있는지, 에이전트가 정상이며 데이터 생산자에서 적절한 양의 CPU와 메모리 리소스를 소비하고 있는지 평가하는 데 도움이 됩니다. 전송된 레코드 수와 바이트 등의 지표는 에이전트가 스트림에 데이터를 제출하는 속도를 이해하는 데 유용합니다. 이러한 측정치가 예상 임계값에 다소 못 미치거나 0으로 떨어지는 경우, 구성 문제, 네트워크 오류 또는 에이전트 상태 문제를 나타낼 수 있습니다. 호스트상의 CPU 및 메모리 소비 등의 측정치와 에이전트 오류 카운터는 데이터 생산자의 리소스 사용량을 나타내며, 잠재적인 구성 또는 호스트 오류에 대한 통찰을 제공합니다. 마지막으로 에이전트는 서비스 예외도 로깅하여 에이전트 문제를 조사하는 데 도움을 줍니다. 이러한 측정치는 에이전트 구성 설정 `cloudwatch.endpoint`에 지정된 리전에서 보고됩니다. 여러 Kinesis 에이전트에서 게시된 CloudWatch 지표는 집계되거나 결합됩니다. 에이전트 구성에 대한 자세한 내용은 [에이전트 구성 설정 지정](writing-with-agents.md#agent-config-settings) 단원을 참조하세요.

## CloudWatch를 사용하여 모니터링
<a name="agent-metrics"></a>

Kinesis Data Streams 에이전트는 CloudWatch에 다음 지표를 전송합니다.


| 지표 | 설명 | 
| --- | --- | 
| BytesSent | 지정된 기간 동안 Kinesis Data Streams에 전송된 바이트 수입니다.<br />단위: 바이트 | 
| RecordSendAttempts | 지정된 기간 동안 `PutRecords`에 대한 호출에서 시도한 레코드 수입니다(처음 또는 다시 시도).<br />단위: 개 | 
| RecordSendErrors | 지정한 기간 동안 재시도를 포함해 `PutRecords`에 대한 호출에서 실패 상태를 반환한 레코드 수입니다.<br />단위: 개 | 
| ServiceErrors | 지정된 기간 동안 서비스 오류(조절 오류 제외)를 일으킨 `PutRecords`에 대한 호출 수입니다.<br />단위: 개 |