本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 使用以下方式监控亚马逊 Kinesis Video Streams 指标 CloudWatch 您可以使用亚马逊监控 Kinesis 视频流 CloudWatch，亚马逊会收集来自亚马逊 Kinesis Video Streams 的原始数据，并将其处理为可读的、近乎实时的指标。这些统计数据记录的时间为 15 个月，因此您可以访问历史信息并更好地了解您的 Web 应用程序或服务的性能。 在[亚马逊 Kinesis Video Stream](https://console.aws.amazon.com//kinesisvideo/home/) s 控制台中，您可以通过两种方式 CloudWatch 查看亚马逊 Kinesis 视频流的指标： + 在 “**控制面板**” 页面中，在 “**当前区域的账户级指标**” 部分中选择 “**视频流**” 选项卡。 + 在视频流的详细信息页面中，选择 **Monitoring (监控)** 选项卡。 亚马逊 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` | 请求与建立连接时的 HTTP 响应之间的时间差。 InletService
单位：计数 | | `PutMedia.BufferingAckLatency` | Amazon Kinesis Video Streams 接收新片段的第一个字节与为该片段发送缓冲 ACK 之间的时间差。
单位：毫秒 | | `PutMedia.ReceivedAckLatency` | Amazon Kinesis Video Streams 收到新片段的最后一个字节与为该片段发送已收到的 ACK 之间的时间差。
单位：毫秒 | | `PutMedia.PersistedAckLatency` | Amazon Kinesis Video Streams 接收新片段的最后一个字节与为该片段发送持久的 ACK 之间的时间差。
单位：毫秒 | | `PutMedia.ErrorAckCount` | 在直播中执行操作时 ACKs 发送`PutMedia`的错误数。
单位：计数 | | `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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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（系统）错误。有关启用请求和响应摘要（包括请求）的更多信息 IDs，请参阅 AWS [请求/响应摘要记录](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** + [数据是否会到达亚马逊 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) ### 数据是否会到达亚马逊 Kinesis Video Streams 服务？ **相关指标：** + `PutMedia.IncomingBytes` + `PutMedia.IncomingFragments` + `PutMedia.IncomingFrames` **操作项：** + 如果这些指标有所下降，请检查您的应用程序是否仍在向服务发送数据。 + 检查网络带宽。如果您的网络带宽不足，可能会降低服务接收数据的速率。 ### 为什么 Amazon Kinesis Video Streams 服务无法成功提取数据？ **相关指标：** + `PutMedia.Requests` + `PutMedia.ConnectionErrors` + `PutMedia.Success` + `PutMedia.ErrorAckCount` **操作项：** + 如果增加了`PutMedia.ConnectionErrors`，请查看生产者客户端收到的 HTTP 响应和错误代码，以了解在建立连接时发生了哪些错误。 + 如果出现下降`PutMedia.Success`或增加`PutMedia.ErrorAckCount`，请查看服务发送的 ack 响应中的 ack 错误代码，以了解数据摄取失败的原因。有关更多信息，请参阅 [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`，请检查网络带宽以及数据是否仍在发送中。 + 如果有漏洞`PutMedia.Success`，请检查ack错误代码。有关更多信息，请参阅 [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`请求返回 response/error 的 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.ConnectionErrors`，请查看`GetMedia`请求返回的 HTTP 响应和错误代码。有关更多信息，请参阅 [AckErrorCode.Values。](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html) + 如果您正在尝试读取最新或实时数据，`PutMedia.IncomingBytes`请检查是否有数据进入流中，以便服务发送给消费者。 + 如果出现下降`GetMedia.Success`或`GetMediaForFragmentList.Success`，则可能是由于服务无法将数据发送给消费者。如果这种情况持续很长时间，请咨询您的客户服务联系人，看看您的服务是否存在问题。