Monitoring Amazon IVS with Amazon CloudWatch - Amazon Interactive Video Service

Monitoring Amazon IVS with Amazon CloudWatch

You can monitor Amazon Interactive Video Service (IVS) resources using Amazon CloudWatch.

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. That is, 1 minute of video was served to 5 viewers, for a total of 300 seconds of data across viewers.

Usually, metric data is emitted within 1 minute of the timestamp to which it refers. In rare cases, the LiveDeliveredTime metric can be delayed up to 4 hours.

To access Amazon IVS metrics using the CloudWatch console:

  1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. In the navigation pane, choose Metrics.

  3. On the All Metrics tab, select IVS as the metric namespace.

  4. Select a metric dimension as desired. See the table below for dimensions.

To access Amazon IVS metrics using the AWS CLI:

  1. Open a command prompt.

  2. Run:

    aws cloudwatch list-metrics --namespace AWS/IVS

For more information, see Using Amazon CloudWatch Metrics in the Amazon CloudWatch User Guide.

Metrics

Amazon IVS provides the following metrics in the AWS/IVS namespace. In all cases, the units are seconds and the valid statistic is sum.

Metric Dimension Description
LiveDeliveredTime None Total real-time duration of video served to all viewers.
LiveDeliveredTime Channel Filters LiveDeliveredTime by channel. Channel values are ARNs.
LiveDeliveredTime Channel, ViewerCountryCode Filters LiveDeliveredTime by channel and viewer’s country code. Channel values are ARNs. Country values are two-character ISO 3166-1 country codes. This allows you to answer the question: where are my viewers watching from? If the viewer’s country cannot be determined, it is shown as UNKNOWN.
LiveInputTime None Real-time duration of video stream.
LiveInputTime Channel Filters LiveInputTime by channel. Channel values are ARNs.