기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CloudWatch를 사용하여 Amazon Kinesis Video Streams 지표 모니터링 Amazon Kinesis Video Streams에서 원시 데이터를 수집하여 읽기 가능하며 실시간에 가까운 지표로 처리하는 Amazon CloudWatchAmazon Kinesis Video Streams을 모니터링할 수 있습니다. 이러한 통계는 15개월 동안 기록되므로 기록 정보에 액세스하고 웹 애플리케이션 또는 서비스의 성능을 더 잘 파악할 수 있습니다. [Amazon Kinesis Video Streams 콘솔](https://console.aws.amazon.com//kinesisvideo/home/)에서는 다음 두 가지 방법으로 Amazon Kinesis 비디오 스트림에 대한 CloudWatch 지표를 볼 수 있습니다. + **대시보드** 페이지의 **현재 리전에 대한 계정 수준 지표** 섹션에서 **비디오 스트림** 탭을 선택합니다. + 비디오 스트림의 세부 정보 페이지에서 **모니터링** 탭을 선택합니다. Amazon Kinesis Video Streams는 다음 지표를 제공합니다. | 지표 | 설명 | | --- | --- | | ArchivedFragmentsConsumed.Media | 모든 APIs. 할당량 포인트의 개념에 대한 설명은 섹션을 참조하세요[조각 메타데이터 및 조각 미디어 할당량](limits.md#fragment_based_throttling).단위: 개 | | ArchivedFragmentsConsumed.Metadata | 모든 APIs. 할당량 포인트의 개념에 대한 설명은 섹션을 참조하세요[조각 메타데이터 및 조각 미디어 할당량](limits.md#fragment_based_throttling).단위: 개 | | `PutMedia.Requests` | 지정된 스트림에 대한 `PutMedia` API 요청 수입니다. 단위: 개 | | `PutMedia.IncomingBytes` | 스트림에 `PutMedia` 대해의 일부로 수신된 바이트 수입니다. 단위: 바이트 | | `PutMedia.IncomingFragments` | 스트림에 `PutMedia` 대해의 일부로 수신된 전체 조각 수입니다. 단위: 개 | | `PutMedia.IncomingFrames` | 스트림에 `PutMedia` 대해의 일부로 수신된 전체 프레임 수입니다. 단위: 개 | | `PutMedia.ActiveConnections` | 서비스 호스트에 대한 총 연결 수입니다. 단위: 개 | | `PutMedia.ConnectionErrors` | 스트림에 대한 `PutMedia` 연결을 설정하는 동안 발생하는 오류입니다. 단위: 개 | | `PutMedia.FragmentIngestionLatency` | Amazon Kinesis Video Streams에서 조각의 첫 번째 바이트와 마지막 바이트를 수신하는 시점 간의 시간 차이입니다. 단위: 밀리초 | | `PutMedia.FragmentPersistLatency` | 전체 조각 데이터를 수신하고 보관한 시간입니다. 단위: 개 | | `PutMedia.Latency` | 연결을 설정하는 동안 요청과 InletService의 HTTP 응답 간의 시간 차이입니다. 단위: 개 | | `PutMedia.BufferingAckLatency` | Amazon Kinesis Video Streams에서 새 조각의 첫 번째 바이트를 수신하는 시점과 조각에 대해 버퍼링 ACK가 전송되는 시점 간의 시간 차이입니다. 단위: 밀리초 | | `PutMedia.ReceivedAckLatency` | Amazon Kinesis Video Streams에서 새 조각의 마지막 바이트를 수신하는 시점과 조각에 대해 수신된 ACK가 전송되는 시점 간의 시간 차이입니다. 단위: 밀리초 | | `PutMedia.PersistedAckLatency` | Amazon Kinesis Video Streams에서 새 조각의 마지막 바이트를 수신하는 시점과 조각에 대해 영구 ACK가 전송되는 시점 간의 시간 차이입니다. 단위: 밀리초 | | `PutMedia.ErrorAckCount` | 스트림에 `PutMedia` 대해 수행하는 동안 전송된 오류 ACKs 수입니다. 단위: 개 | | `PutMedia.Success` | 조각이 성공적으로 기록될 때마다 1, 조각이 실패할 때마다 0이 계산됩니다. 이 지표의 평균 값으로 완전하고 유효한 조각의 전송 수를 나타냅니다. 단위: 개 | | `GetMedia.Requests` | 지정된 스트림에 대한 `GetMedia` API 요청 수입니다. 단위: 개 | | `GetMedia.OutgoingBytes` | 지정된 스트림에 대한 `GetMedia` API의 일부로 서비스에서 전송된 총 바이트 수입니다. 단위: 바이트 | | `GetMedia.OutgoingFragments` | 스트림에 `GetMedia` 대해를 수행하는 동안 전송된 조각 수입니다. 단위: 개 | | `GetMedia.OutgoingFrames` | 지정된 스트림`GetMedia`에서 동안 전송된 프레임 수입니다. 단위: 개 | | `GetMedia.MillisBehindNow` | 현재 서버 타임스탬프와 마지막으로 전송된 조각의 서버 타임스탬프 간의 시간 차이입니다. 단위: 밀리초 | | `GetMedia.ConnectionErrors` | 설정되지 않은 연결 수입니다. 단위: 개 | | `GetMedia.Success` | 조각이 성공적으로 전송될 때마다 1, 실패할 때마다 0이 계산됩니다. 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetMediaForFragmentList.OutgoingBytes` | 지정된 스트림에 대한 `GetMediaForFragmentList` API의 일부로 서비스에서 전송된 총 바이트 수입니다. 단위: 바이트 | | `GetMediaForFragmentList.OutgoingFragments` | 지정된 스트림에 대한 `GetMediaForFragmentList` API의 일부로 서비스에서 전송된 총 조각 수입니다. 단위: 개 | | `GetMediaForFragmentList.OutgoingFrames` | 지정된 스트림에 대한 `GetMediaForFragmentList` API의 일부로 서비스에서 전송된 총 프레임 수입니다. 단위: 개 | | `GetMediaForFragmentList.Requests` | 지정된 스트림에 대한 `GetMediaForFragmentList` API 요청 수입니다. 단위: 개 | | `GetMediaForFragmentList.Success` | 조각이 성공적으로 전송될 때마다 1, 실패할 때마다 0이 계산됩니다. 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `ListFragments.Latency` | 지정된 스트림 이름에 대한 `ListFragments` API 호출의 지연 시간입니다. 단위: 밀리초 | | `ListFragments.Requests` | 지정된 스트림에 대한 `ListFragments` API 요청 수입니다. 단위: 개 | | `ListFragments.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetHLSStreamingSessionURL.Latency` | 지정된 스트림 이름에 대한 `GetHLSStreamingSessionURL` API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetHLSStreamingSessionURL.Requests` | 지정된 스트림에 대한 `GetHLSStreamingSessionURL` API 요청 수입니다. 단위: 개 | | `GetHLSStreamingSessionURL.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetHLSMasterPlaylist.Latency` | 지정된 스트림 이름에 대한 `GetHLSMasterPlaylist` API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetHLSMasterPlaylist.Requests` | 지정된 스트림에 대한 `GetHLSMasterPlaylist` API 요청 수입니다. 단위: 개 | | `GetHLSMasterPlaylist.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetHLSMediaPlaylist.Latency` | 지정된 스트림 이름에 대한 `GetHLSMediaPlaylist` API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetHLSMediaPlaylist.Requests` | 지정된 스트림에 대한 `GetHLSMediaPlaylist` API 요청 수입니다. 단위: 개 | | `GetHLSMediaPlaylist.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetMP4InitFragment.Latency` | 지정된 스트림 이름에 대한 `GetMP4InitFragment` API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetMP4InitFragment.Requests` | 지정된 스트림에 대한 `GetMP4InitFragment` API 요청 수입니다. 단위: 개 | | `GetMP4InitFragment.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetMP4MediaFragment.Latency` | 지정된 스트림 이름에 대한 `GetMP4MediaFragment` API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetMP4MediaFragment.Requests` | 지정된 스트림에 대한 `GetMP4MediaFragment` API 요청 수입니다. 단위: 개 | | `GetMP4MediaFragment.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetMP4MediaFragment.OutgoingBytes` | 지정된 스트림에 대한 `GetMP4MediaFragment` API의 일부로 서비스에서 전송된 총 바이트 수입니다. 단위: 바이트 | | `GetTSFragment.Latency` | 지정된 스트림 이름에 대한 `GetTSFragment` API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetTSFragment.Requests` | 지정된 스트림에 대한 `GetTSFragment` API 요청 수입니다. 단위: 개 | | `GetTSFragment.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetTSFragment.OutgoingBytes` | 지정된 스트림에 대한 `GetTSFragment` API의 일부로 서비스에서 전송된 총 바이트 수입니다. 단위: 바이트 | | `GetDASHStreamingSessionURL.Latency` | 지정된 스트림 이름에 대한 `GetDASHStreamingSessionURL` API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetDASHStreamingSessionURL.Requests` | 지정된 스트림에 대한 `GetDASHStreamingSessionURL` API 요청 수입니다. 단위: 개 | | `GetDASHStreamingSessionURL.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetDASHManifest.Latency` | 지정된 스트림 이름에 대한 `GetDASHManifest` API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetDASHManifest.Requests` | 지정된 스트림에 대한 `GetDASHManifest` API 요청 수입니다. 단위: 개 | | `GetDASHManifest.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetClip.Latency` | 지정된 비디오 스트림 이름에 대한 GetClip API 호출의 지연 시간입니다. 단위: 밀리초 | | `GetClip.Requests` | 지정된 비디오 스트림에 대한 GetClip API 요청 수입니다. 단위: 개 | | `GetClip.Success` | 요청이 성공할 때마다 1, 실패할 때마다 0 평균 값으로 성공률이 표시됩니다. 400 (사용자) 에러와 500 (시스템) 에러가 모두 발생했습니다. AWS 요청 IDs를 포함하여 요청 및 응답 요약을 활성화하는 방법에 대한 자세한 내용은 [요청/응답 요약 로깅](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response)을 참조하세요. 단위: 개 | | `GetClip.OutgoingBytes` | 지정된 비디오 스트림에 대해 GetClip API의 일부로 서비스에서 전송된 총 바이트 수입니다. 단위: 바이트 | ## CloudWatch 지표 지침 CloudWatch 지표는 다음 질문에 대한 답변을 찾는 데 도움이 될 수 있습니다. **Topics** + [데이터가 Amazon Kinesis Video Streams 서비스에 도달하나요?](#monitoring-cloudwatch-guidance-incoming) + [Amazon Kinesis Video Streams 서비스에서 데이터를 성공적으로 수집하지 못하는 이유는 무엇인가요?](#monitoring-cloudwatch-guidance-errors) + [생산자로부터 전송되는 것과 동일한 속도로 Amazon Kinesis Video Streams 서비스에서 데이터를 읽을 수 없는 이유는 무엇입니까?](#monitoring-cloudwatch-guidance-rate) + [콘솔에 비디오가 없거나 비디오가 지연되어 재생되는 이유는 무엇입니까?](#monitoring-cloudwatch-guidance-novideo) + [실시간 데이터 읽기가 지연되는 이유는 무엇이며 클라이언트가 스트림의 헤드보다 지연되는 이유는 무엇입니까?](#monitoring-cloudwatch-guidance-delay) + [클라이언트가 Kinesis 비디오 스트림에서 데이터를 읽고 있으며, 그 속도는 얼마입니까?](#monitoring-cloudwatch-guidance-isread) + [클라이언트가 Kinesis 비디오 스트림에서 데이터를 읽을 수 없는 이유는 무엇입니까?](#monitoring-cloudwatch-guidance-noread) ### 데이터가 Amazon Kinesis Video Streams 서비스에 도달하나요? **관련 측정치:** + `PutMedia.IncomingBytes` + `PutMedia.IncomingFragments` + `PutMedia.IncomingFrames` **작업 항목:** + 이러한 지표가 감소한 경우 애플리케이션이 여전히 서비스에 데이터를 전송하고 있는지 확인합니다. + 네트워크 대역폭을 확인합니다. 네트워크 대역폭이 충분하지 않으면 서비스에서 데이터를 수신하는 속도가 느려질 수 있습니다. ### Amazon Kinesis Video Streams 서비스에서 데이터를 성공적으로 수집하지 못하는 이유는 무엇인가요? **관련 측정치:** + `PutMedia.Requests` + `PutMedia.ConnectionErrors` + `PutMedia.Success` + `PutMedia.ErrorAckCount` **작업 항목:** + 가 증가하면 생산자 클라이언트가 수신한 HTTP 응답 및 오류 코드를 `PutMedia.ConnectionErrors`살펴보고 연결을 설정하는 동안 어떤 오류가 발생하는지 확인합니다. + 가 감소`PutMedia.Success`하거나 증가하면 서비스에서 전송한 ack 응답의 ack 오류 코드를 `PutMedia.ErrorAckCount`살펴보고 데이터 수집이 실패하는 이유를 확인합니다. 자세한 내용은 [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html) 단원을 참조하십시오. ### 생산자로부터 전송되는 것과 동일한 속도로 Amazon Kinesis Video Streams 서비스에서 데이터를 읽을 수 없는 이유는 무엇입니까? **관련 측정치:** + `PutMedia.FragmentIngestionLatency` + `PutMedia.IncomingBytes` **작업 항목:** + 이러한 지표가 감소하면 연결의 네트워크 대역폭을 확인합니다. 낮은 대역폭 연결로 인해 데이터가 낮은 속도로 서비스에 도달할 수 있습니다. ### 콘솔에 비디오가 없거나 비디오가 지연되어 재생되는 이유는 무엇입니까? **관련 측정치:** + `PutMedia.FragmentIngestionLatency` + `PutMedia.FragmentPersistLatency` + `PutMedia.Success` + `ListFragments.Latency` + `PutMedia.IncomingFragments` **작업 항목:** + 가 증가`PutMedia.FragmentIngestionLatency`하거나 감소하는 경우 네트워크 대역폭과 데이터가 여전히 전송 중인지 `PutMedia.IncomingFragments`확인합니다. + 에 드롭이 있는 경우 ack 오류 코드를 `PutMedia.Success`확인합니다. 자세한 내용은 [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html) 단원을 참조하십시오. + `PutMedia.FragmentPersistLatency` 또는가 증가하면 서비스 문제가 발생할 가능성이 `ListFragments.Latency`높습니다. 조건이 장기간 지속되는 경우 고객 서비스 담당자에게 문의하여 서비스에 문제가 있는지 확인하세요. ### 실시간 데이터 읽기가 지연되는 이유는 무엇이며 클라이언트가 스트림의 헤드보다 지연되는 이유는 무엇입니까? **관련 측정치:** + `GetMedia.MillisBehindNow` + `GetMedia.ConnectionErrors` + `GetMedia.Success` **작업 항목:** + 가 증가`GetMedia.ConnectionErrors`하면 스트림에 다시 연결하려는 빈번한 시도로 인해 소비자가 스트림을 읽는 데 뒤처질 수 있습니다. `GetMedia` 요청에 반환된 HTTP 응답/오류 코드를 확인합니다. + 에 드롭이 있는 경우 서비스가 소비자에게 데이터를 전송할 수 없어 연결이 끊어지고 소비자로부터 다시 연결되어 소비자가 스트림 헤드 뒤에서 지연되기 때문`GetMedia.Success`일 수 있습니다. + 가 증가하는 경우 대역폭 제한을 `GetMedia.MillisBehindNow`살펴보고 대역폭이 낮기 때문에 더 느린 속도로 데이터를 수신하고 있는지 확인합니다. ### 클라이언트가 Kinesis 비디오 스트림에서 데이터를 읽고 있으며, 그 속도는 얼마입니까? **관련 측정치:** + `GetMedia.OutgoingBytes` + `GetMedia.OutgoingFragments` + `GetMedia.OutgoingFrames` + `GetMediaForFragmentList.OutgoingBytes` + `GetMediaForFragmentList.OutgoingFragments` + `GetMediaForFragmentList.OutgoingFrames` **작업 항목:** + 이러한 지표는 실시간 및 보관된 데이터를 읽는 속도를 나타냅니다. ### 클라이언트가 Kinesis 비디오 스트림에서 데이터를 읽을 수 없는 이유는 무엇입니까? **관련 측정치:** + `GetMedia.ConnectionErrors` + `GetMedia.Success` + `GetMediaForFragmentList.Success` + `PutMedia.IncomingBytes` **작업 항목:** + 가 증가하면 `GetMedia` 요청에서 반환된 HTTP 응답 및 오류 코드를 `GetMedia.ConnectionErrors`살펴봅니다. 자세한 내용은 [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html) 단원을 참조하십시오. + 최신 또는 라이브 데이터를 읽으려는 경우 서비스가 소비자에게 전송할 스트림에 데이터가 들어오는`PutMedia.IncomingBytes`지 확인합니다. + `GetMedia.Success` 또는에 드롭이 있는 경우 서비스가 소비자에게 데이터를 전송할 수 없기 `GetMediaForFragmentList.Success`때문일 수 있습니다. 조건이 장기간 지속되는 경우 고객 서비스 담당자에게 문의하여 서비스에 문제가 있는지 확인하세요.