AWS Documentation » Amazon Kinesis Video Streams » Developer Guide » Monitoring Kinesis Video Streams » Monitoring Kinesis Video Streams Metrics with CloudWatch

Monitoring Kinesis Video Streams Metrics with CloudWatch

You can monitor a Kinesis video stream using Amazon CloudWatch, which collects and processes raw data from Kinesis Video Streams into readable, near real-time metrics. These statistics are recorded for a period of 15 months, so that you can access historical information and gain a better perspective on how your web application or service is performing.

To access the CloudWatch dashboard for a Kinesis video stream, choose View stream metrics in CloudWatch in the Stream info section of the console page for the stream.

Kinesis Video Streams provides the following metrics:

Metric	Description
PutMedia.Requests	Number of PutMedia API requests for a given stream. Units: Count
PutMedia.IncomingBytes	Number of bytes received as part of PutMedia for the stream. Units: Bytes
PutMedia.IncomingFragments	Number of complete fragments received as part of PutMedia for the stream. Units: Count
PutMedia.IncomingFrames	Number of complete frames received as part of PutMedia for the stream. Units: Count
PutMedia.ActiveConnections	The total number of connections to the service host. Units: Count
PutMedia.ConnectionErrors	Errors while establishing PutMedia connection for the stream. Units: Count
PutMedia.FragmentIngestionLatency	Time difference between when the first and last bytes of a fragment are received by Kinesis Video Streams. Units: Milliseconds
PutMedia.FragmentPersistLatency	Time taken from when the complete fragment data is received and archived. Units: Count
PutMedia.Latency	Time difference between the request and the HTTP response from InletService while establishing the connection. Units: Count
PutMedia.BufferingAckLatency	Time difference between when the first byte of a new fragment is received by Kinesis Video Streams and when the Buffering ACK is sent for the fragment. Units: Milliseconds
PutMedia.ReceivedAckLatency	Time difference between when the last byte of a new fragment is received by Kinesis Video Streams and when the Received ACK is sent for the fragment. Units: Milliseconds
PutMedia.PersistedAckLatency	Time difference between when the last byte of a new fragment is received by Kinesis Video Streams and when the Persisted ACK is sent for the fragment. Units: Milliseconds
PutMedia.ErrorAckCount	Number of Error ACKs sent while doing PutMedia for the stream. Units: Count
PutMedia.Success	1 for each fragment successfully written; 0 for every failed fragment. The average value of this metric indicates how many complete, valid fragments are sent. Units: Count
GetMedia.Requests	Number of GetMedia API requests for a given stream. Units: Count
GetMedia.OutgoingBytes	Total number of bytes sent out from the service as part of the GetMedia API for a given stream. Units: Bytes
GetMedia.OutgoingFragments	Number of fragments sent while doing GetMedia for the stream. Units: Count
GetMedia.OutgoingFrames	Number of frames sent during GetMedia on the given stream. Units: Count
GetMedia.MillisBehindNow	Time difference between the current server time stamp and the server time stamp of the last fragment sent. Units: Milliseconds
GetMedia.ConnectionErrors	The number of connections that were not successfully established. Units: Count
GetMedia.Success	1 for every fragment successfully sent; 0 for every failure. The average value indicates the rate of success. Units: Count
GetMediaForFragmentList.OutgoingBytes	Total number of bytes sent out from the service as part of the GetMediaForFragmentList API for a given stream. Units: Bytes
GetMediaForFragmentList.OutgoingFragments	Total number of fragments sent out from the service as part of the GetMediaForFragmentList API for a given stream. Units: Count
GetMediaForFragmentList.OutgoingFrames	Total number of frames sent out from the service as part of the GetMediaForFragmentList API for a given stream. Units: Count
GetMediaForFragmentList.Requests	Number of GetMediaForFragmentList API requests for a given stream. Units: Count
GetMediaForFragmentList.Success	1 for every fragment successfully sent; 0 for every failure. The average value indicates the rate of success. Units: Count
ListFragments.Latency	Latency of the ListFragments API calls for the given stream name. Units: Milliseconds
GetHLSStreamingSessionURL.Latency	Latency of the GetHLSStreamingSessionURL API calls for the given stream name. Units: Milliseconds
GetHLSStreamingSessionURL.Requests	Number of GetHLSStreamingSessionURL API requests for a given stream. Units: Count
GetHLSStreamingSessionURL.Success	1 for every successful request; 0 for every failure. The average value indicates the rate of success. Units: Count
GetHLSMasterPlaylist.Latency	Latency of the GetHLSMasterPlaylist API calls for the given stream name. Units: Milliseconds
GetHLSMasterPlaylist.Requests	Number of GetHLSMasterPlaylist API requests for a given stream. Units: Count
GetHLSMasterPlaylist.Success	1 for every successful request; 0 for every failure. The average value indicates the rate of success. Units: Count
GetHLSMediaPlaylist.Latency	Latency of the GetHLSMediaPlaylist API calls for the given stream name. Units: Milliseconds
GetHLSMediaPlaylist.Requests	Number of GetHLSMediaPlaylist API requests for a given stream. Units: Count
GetHLSMediaPlaylist.Success	1 for every successful request; 0 for every failure. The average value indicates the rate of success. Units: Count
GetMP4InitFragment.Latency	Latency of the GetMP4InitFragment API calls for the given stream name. Units: Milliseconds
GetMP4InitFragment.Requests	Number of GetMP4InitFragment API requests for a given stream. Units: Count
GetMP4InitFragment.Success	1 for every successful request; 0 for every failure. The average value indicates the rate of success. Units: Count
GetMP4MediaFragment.Latency	Latency of the GetMP4MediaFragment API calls for the given stream name. Units: Milliseconds
GetMP4MediaFragment.Requests	Number of GetMP4MediaFragment API requests for a given stream. Units: Count
GetMP4MediaFragment.Success	1 for every successful request; 0 for every failure. The average value indicates the rate of success. Units: Count
GetMP4MediaFragment.OutgoingBytes	Total number of bytes sent out from the service as part of the GetMP4MediaFragment API for a given stream. Units: Bytes

CloudWatch Metrics Guidance

CloudWatch metrics can be useful for finding answers to the following questions:

Is data reaching the Kinesis Video Streams service?

Relevant metrics:

• PutMedia.IncomingBytes

• PutMedia.IncomingFragments

• PutMedia.IncomingFrames

Action items:

• If there is a drop in these metrics, check if your application is still sending data to the service.

• Check the network bandwidth. If your network bandwidth is insufficient, it could be slowing down the rate the service is receiving the data.

Why is data not being successfully ingested by the Kinesis Video Streams service?

Relevant metrics:

• PutMedia.Requests

• PutMedia.ConnectionErrors

• PutMedia.Success

• PutMedia.ErrorAckCount

Action items:

• If there is an increase in PutMedia.ConnectionErrors, look at the HTTP response/error codes received by the producer client to see what errors are occurring while establishing the connection.

• If there is a drop in PutMedia.Success or increase in PutMedia.ErrorAckCount, look at the ack error code in the ack responses sent by the service to see why ingestion of data is failing. For more information, see AckErrorCode.Values.

Why can't the data be read from the Kinesis Video Streams service at the same rate as it's being sent from the producer?

Relevant metrics:

• PutMedia.FragmentIngestionLatency

• PutMedia.IncomingBytes

Action items:

• If there is a drop in these metrics, check the network bandwidth of your connections. Low-bandwidth connections could cause the data to reach the service at a lower rate.

Why is there no video in the console, or why is the video being played with a delay?

Relevant metrics:

• PutMedia.FragmentIngestionLatency

• PutMedia.FragmentPersistLatency

• PutMedia.Success

• ListFragments.Latency

• PutMedia.IncomingFragments

Action items:

• If there is an increase in PutMedia.FragmentIngestionLatency or a drop in PutMedia.IncomingFragments, check the network bandwidth and whether the data is still being sent.

• If there is a drop in PutMedia.Success, check the ack error codes. For more information, see AckErrorCode.Values.

• If there is an increase in PutMedia.FragmentPersistLatency or ListFragments.Latency, you are most likely experiencing a service issue. If the condition persists for an extended period of time, check with your customer service contact to see if there is an issue with your service.

What is the delay in reading real-time data, and why is the client lagging behind the head of the stream?

Relevant metrics:

• GetMedia.MillisBehindNow

• GetMedia.ConnectionErrors

• GetMedia.Success

Action items:

• If there is an increase in GetMedia.ConnectionErrors, then the consumer might be falling behind in reading the stream, due to frequent attempts to re-connect to the stream. Look at the HTTP response/error codes returned for the GetMedia request.

• If there is a drop in GetMedia.Success, then it’s likely due to the service being unable to send the data to the consumer, which would result in dropped connection, and reconnects from consumers, which would result in the consumer lagging behind the head of the stream.

• If there is an increase in GetMedia.MillisBehindNow, look at your bandwidth limits to see if you are receiving the data at a slower rate because of lower bandwidth.

Is the client reading data out of the Kinesis video stream, and at what rate?

Relevant metrics:

• GetMedia.OutgoingBytes

• GetMedia.OutgoingFragments

• GetMedia.OutgoingFrames

• GetMediaForFragmentList.OutgoingBytes

• GetMediaForFragmentList.OutgoingFragments

• GetMediaForFragmentList.OutgoingFrames

Action items:

• These metrics indicate what rate real-time and archived data is being read.

Why can't the client read data out of the Kinesis video stream?

Relevant metrics:

• GetMedia.ConnectionErrors

• GetMedia.Success

• GetMediaForFragmentList.Success

• PutMedia.IncomingBytes

Action items:

• If there is an increase in GetMedia.ConnectionErrors, look at the HTTP response/error codes returned by the GetMedia request. For more information, see AckErrorCode.Values.

• If you are trying to read the latest/live data, check PutMedia.IncomingBytes to see if there is data coming into the stream for the service to send to the consumers.

• If there is a drop in GetMedia.Success or GetMediaForFragmentList.Success, it’s likely due to the service being unable to send the data to the consumer. If the condition persists for an extended period of time, check with your customer service contact to see if there is an issue with your service.