Monitoring Amazon IVS with Amazon CloudWatch
You can monitor Amazon Interactive Video Service (IVS) resources using Amazon CloudWatch. CloudWatch collects and processes raw data from Amazon IVS into readable, near real-time metrics. These statistics are kept for 15 months, so you can gain a historical perspective on how your web application or service performs. You can set alarms for certain thresholds and send notifications or take actions when those thresholds are met. For details, see the CloudWatch User Guide.
The timestamp on a metric represents the start of the period during which metric data is
accumulated. For example, suppose you get a per-minute LiveDeliveredTime
metric
sum of 300 seconds at 01:02:00. This would mean that 5 minutes’ worth of video was served to
viewers during the 1-minute period from 01:02:00 to 01:02:59.
For metrics designated as high resolution, the first data point appears several seconds after stream start. We recommend you specify a 5-second period when making the metric requests. (See Resolution in the Amazon CloudWatch User Guide.) For other metrics, data is emitted within 1 minute of the timestamp to which it refers.
The high-resolution metrics are rolled up over time. Resolution effectively decreases as the metrics age. Here is the schedule:
-
1-second metrics are available for 3 hours.
-
60-second metrics are available for 15 days.
-
5-minute metrics are available for 63 days.
-
1-hour metrics are available for 455 days (15 months).
For current information on data retention, search for "retention period" in Amazon CloudWatch FAQs
Console Instructions
To access Amazon IVS metrics using the CloudWatch console:
-
Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/
. -
In the navigation pane, choose Metrics.
-
On the All metrics tab, using the unlabeled dropdown at the left, select your "home" region, where your channel(s) was(were) created. For more on regions, see Global Solution, Regional Control. For a list of supported regions, see the Amazon IVS page in the AWS General Reference.
-
If IVS appears as a selectable service under AWS Namespaces, select it. It will be listed if you use Amazon IVS and it is sending metrics to Amazon CloudWatch. (If IVS is not listed, you do not have any Amazon IVS metrics.) For example:
-
Choose a metric dimension as desired. For available dimensions, see the Metrics table below.
For Amazon IVS Chat, the instructions are the same but the namespace is IVSChat.
CLI Instructions
You also can access the metrics using the AWS CLI. This requires that you first download and configure the CLI on your machine. For details, see the AWS Command Line Interface User Guide.
Then, to access Amazon IVS metrics using the AWS CLI:
-
At a command prompt, run:
aws cloudwatch list-metrics --namespace AWS/IVS
For Amazon IVS Chat, specify the AWS/IVSChat
namespace at the command
prompt.
For more information, see Using Amazon CloudWatch Metrics in the Amazon CloudWatch User Guide.
Metrics
Amazon IVS
Amazon IVS provides the following metrics in the AWS/IVS namespace.
Metric | Dimension | Description |
---|---|---|
|
None |
A count of concurrent views across all your live channels. A view is a unique viewing session which is actively downloading or playing video. (For a more detailed definition, see the Glossary.) If channels are live but in aggregate have no views, the value of this metric is 0. If no channels are live, the metric has no data points. Unit: Count Valid statistics: Average, Maximum, Minimum — Average number, largest number, or smallest number (respectively) of concurrent views over the configured interval. |
|
|
Filters This metric provides data for a channel, not a stream. To see
concurrent views for a particular streaming session on a given
channel, evaluate the Unit: Count Valid statistics: Average, Maximum, Minimum — Average number, largest number, or smallest number (respectively) of concurrent views over the configured interval. |
|
None |
A count of your channels which are streaming live. If no channels are live, this metric has no data points. Unit: Count Valid statistics: Average, Maximum, Minimum — Average number, largest number, or smallest number (respectively) of concurrent streams over the configured interval. |
|
|
Filters Unit: Count Valid statistics: Average, Maximum, Minimum — Average number,
largest number, or smallest number (respectively) of concurrent
streams for a specific |
|
|
(High-resolution metric) The amount of audio data Amazon IVS receives when you stream. A higher bitrate takes up more of your available internet bandwidth. Unit: Bits per second Valid statistics: Average, Maximum, Minimum — Average number, largest number, or smallest number (respectively) of ingest audio bitrates over the configured interval |
|
|
(High-resolution metric) How often animation frames are received by Amazon IVS when you stream. Unit: Frames per second Valid statistics: Average, Maximum, Minimum — Average number, largest number, or smallest number (respectively) of ingest framerates over the configured interval |
|
|
(High-resolution metric) The amount of video data Amazon IVS receives when you stream. A higher bitrate takes up more of your available internet bandwidth. Higher bitrate can improve video quality, but only up to a certain point. Unit: Bits per second Valid statistics: Average, Maximum, Minimum — Average number, largest number, or smallest number (respectively) of ingest video bitrates over the configured interval |
|
|
(High-resolution metric) The point in the video stream where the entire frame is sent instead of just the differences from the previous frame. Unit: Seconds Valid statistics: Average, Maximum, Minimum — Average number, largest number, or smallest number (respectively) of keyframe intervals over the configured interval |
|
None | Total real-time duration of video served to all viewers. Unit: Seconds Valid statistic: Sum |
|
|
Filters Unit: Seconds Valid statistic: Sum |
|
|
Filters Unit: Seconds Valid statistic: Sum |
|
None | Real-time duration of video stream. Unit: Seconds Valid statistic: Sum |
|
|
Filters Unit: Seconds Valid statistic: Sum |
|
None | Real-time duration of recorded video. Unit: Seconds Valid statistic: Sum |
|
|
Filters Unit: Seconds Valid statistic: Sum |
Amazon IVS Chat
Amazon IVS Chat provides the following metrics in the AWS/IVSChat namespace.
Metric | Dimension | Description |
---|---|---|
|
None |
The total number of concurrent connections in a chat room (reported max per minute). This is useful to understand when customers approach their limit for concurrent chat connections in a region. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
Action |
The number of deliveries of messaging requests made of a specific action type to chat connections across all your rooms in a region. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
|
The number of invocation errors of a specific message review handler across all your rooms in a region. An invocation error occurs when the message review handler cannot be invoked. Invocation errors occur when Amazon IVS Chat cannot invoke a handler. This may happen if the handler associated with a room no longer exists or times out, or if its resource policy does not allow the service to invoke it. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
|
The number of access-denied errors of a log destination across all your rooms in a region. These errors occur when Amazon IVS Chat cannot access the destination resource you specified in the logging configuration. This may happen if the destination resource policy does not allow the service to put records. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
|
The number of all errors of a log destination across all your rooms in a region. This is an aggregated metric which includes all types of errors that occur when Amazon IVS Chat fails to deliver logs to the destination resource you specified in the logging configuration. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
|
The number of resource-not-found errors of a log destination across all your rooms in a region. These errors occur when Amazon IVS Chat cannot deliver logs to a destination resource you specified in a logging configuration because the resource does not exist. This may happen if the destination resource associated with a logging configuration no longer exists. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
None |
The number of deliveries of messaging requests to chat connections across all your rooms in a region. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
None |
The number of messaging requests made across all your rooms in a region. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
Action |
The number of requests made of a specific action type across all your rooms in a region. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |
|
|
The number of response-validation errors of a specific message review handler across all your rooms in a region. A response-validation error occurs when the response from the message review handler is invalid. This may mean that the response could not be parsed or fails validation checks; e.g., an invalid review result or response values that are too long. Unit: Count Valid statistics: Sum, Average, Maximum, Minimum |