Amazon Kinesis Video Stream Integration
A fully managed video ingestion and storage service that helps you securely stream video and time encoded data from millions of connected devices to AWS. With Site24x7's integration you can now collect, monitor and visualize usage and performance across a variety of metrics to understand the behavior of your video streaming application.
Setup and configuration
- If you haven't done it already, enable access to your AWS resource by creating Site24x7 as an IAM user or by creating a cross-account IAM role between your account and Site24x7's AWS account. Learn more.
- Next, in the Integrate AWS Account page, please make sure the Kinesis Video Stream checkbox is selected in the Services to be discovered field. Learn more.
Policies and permissions
Please make sure the following read level actions are present in the IAM policy assigned to the Site24x7 entity. Learn more.
- "kinesisvideo:ListStreams",
- "kinesisvideo:ListTagsForStream",
- "kinesisvideo:DescribeStream"
Polling frequency
Site24x7 queries the CloudWatch API as per the poll frequency set (1 minute to a day), to collect performance metrics. Learn more.
To view metrics
- Log in to the Site24x7 console, click on AWS > Monitored AWS account and select Kinesis Video Streams from the drop down
- From the list of monitored video streams, choose the stream for which you want to access metrics for.
- The various graphs applicable for your video stream are displayed in the Stream Details tab.
Supported metrics
The following performance metrics is collected per video stream
| Attribute | Description | Data type | Statistics |
|---|---|---|---|
| PutMedia.Requests | Measures the number of PUTMedia requests at a stream level. | Count | Sum |
| PutMedia.IncomingBytes | Measures the number of bytes received as part of the PutMedia API call at a stream level | Bytes | Sum |
| PutMedia.IncomingFragments | Measures the number of complete fragments received as part of the PutMedia API call, at a stream level. | Count | Sum |
| PutMedia.IncomingFrames | Measures the number of complete frames received as part of the PutMedia API call, at a stream level. | Count | Sum |
| PutMedia.ActiveConnections | Measures the total number of active connections to the video stream host. | Count | Sum |
| PutMedia.ConnectionErrors | Measures the number of errors while establishing PutMedia connection, at a stream level. | Count | Sum |
| PutMedia.FragmentIngestionLatency | Measures the time lapse between when the first and last bytes of a fragment are received by video streams. | Milliseconds | Average |
| PutMedia.FragmentPersistLatency | Measures the time taken from when the complete fragment data is received and archived. | Milliseconds | Average |
| PutMedia.Latency | Measures the time difference between the request and the HTTP response from InletService while establishing the connection. | Milliseconds | Average |
| PutMedia.BufferingAckLatency | Measures the time lapse between when the first byte of a new fragment is received by video streams and when the Buffering Ack is sent for the fragment | Milliseconds | Average |
| PutMedia.ReceivedAckLatency | Measures the time difference between when the last byte of a new fragment is received by video streams and when the Received ACK is sent for the fragment. | Milliseconds | Average |
| PutMedia.PersistedAckLatency | Measures the time difference between when the last byte of a new fragment is received by the video streams and when the Persisted ACK is sent for the fragment. | Milliseconds | Average |
| PutMedia.ErrorAckCount | Measures the number of Error ACKs sent while PutMedia API call, at a stream level. | Count | Sum |
| PutMedia.Success | The metric increments by 1 for each successfully written fragment; 0 for every failed fragment. | Count | Sum |
| GetMedia.Requests | Measures the number of GetMedia API requests, at a stream level. | Count | Sum |
| GetMedia.OutgoingBytes | Measures the total number of bytes sent out from the service as part of the GetMedia API | Bytes | Sum |
| GetMedia.OutgoingFragments | Measure the number of fragments sent while doing GetMedia for the stream. | Count | Sum |
| GetMedia.OutgoingFrames | Measure the number of frames sent during GetMedia on the given stream. | Count | Sum |
| GetMedia.MillisBehindNow | Measures the time difference between the current server time stamp and the server time stamp of the last fragment sent. | Milliseconds | Maximum |
| GetMedia.ConnectionErrors | Measures the number of connections that were not successfully established. | Count | Sum |
| GetMedia.Success | The metric increments by 1 for every succesfull fragment sent; 0 for every failed fragment. | Count | Sum |
| GetMediaForFragmentList.OutgoingBytes | Measures the total number of bytes sent out from the service as part of the GetMediaForFragmentList API | Bytes | Sum |
| GetMediaForFragmentList.OutgoingFrames | Measures the total number of frames sent out from the service as part of the GetMediaForFragmentList API | Count | Sum |
| GetMediaForFragmentList.OutgoingFragments | Measures the total number of fragments sent out from the service as part of the GetMediaForFragmentList API | Count | Sum |
| GetMediaForFragmentList.Requests | Measures the number of GetMediaForFragmentList API requests for a given stream. | Count | Sum |
| GetMediaForFragmentList.Success | The Metric increment by 1 for every fragment successfully sent; 0 for every failure | Count | Sum |
| ListFragments.Latency | Measures the latency of the ListFragments API calls | Milliseconds | Average |
Configuration details
The following configuration data are collected per video stream
| Attribute | Description |
|---|---|
| Stream Name | Displays the name for the stream. |
| Stream ARN | Displays the Amazon Resource Name (ARN) of the stream. |
| Creation Time | Displays the stream creation time stamp. |
| Media type | Displays the media type of the stream. |
| Status | Displays the most current status of the stream |
| Version | Displays the version number for the video stream |
| Data Retention Period | Displays the current retention period, in hours. |
| KMS Key | The ID of the AWS KMS key that you use to encrypt stream data. |
| Device Name | Displays the name of the device that is writing to the stream |