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. 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.

Usually, metric data is emitted within 1 minute of the timestamp to which it refers.

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:

  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, 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.

  4. 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:

  5. Choose a metric dimension as desired. For available dimensions, see the Metrics table below.

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 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.

Metric Dimension Description

ConcurrentViews

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.

ConcurrentViews

Channel

Filters ConcurrentViews by channel ARN. If a channel is live but has no views, the value of this metric is 0. If a channel is not live, the metric has no data points.

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 ConcurrentViews metric for that channel between the start and end times of the streaming session.

Unit: Count

Valid statistics: Average, Maximum, Minimum — Average number, largest number, or smallest number (respectively) of concurrent views over the configured interval.

ConcurrentStreams

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.

LiveDeliveredTime

None

Total real-time duration of video served to all viewers.

Unit: Seconds

Valid statistic: Sum

LiveDeliveredTime

Channel

Filters LiveDeliveredTime by channel. Channel values are ARNs.

Unit: Seconds

Valid statistic: Sum

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.

Unit: Seconds

Valid statistic: Sum

LiveInputTime

None

Real-time duration of video stream.

Unit: Seconds

Valid statistic: Sum

LiveInputTime

Channel

Filters LiveInputTime by channel. Channel values are ARNs.

Unit: Seconds

Valid statistic: Sum

RecordedTime

None

Real-time duration of recorded video.

Unit: Seconds

Valid statistic: Sum

RecordedTime

Channel

Filters RecordedTime by channel. Channel values are ARNs.

Unit: Seconds

Valid statistic: Sum