监控 Amazon IVS Real-Time Streaming - Amazon IVS
什么是舞台会话？查看舞台会话和参与者查看参与者的事件访问 CloudWatch 指标CloudWatch 指标：IVS 实时直播功能

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

监控 Amazon IVS Real-Time Streaming

什么是舞台会话？

当第一个参与者加入舞台时，舞台会话开始，最后一个参与者停止发布到舞台的几分钟后，舞台会话结束。舞台会话将事件和参与者分成短期会话，帮助调试持续时间较长的舞台。

查看舞台会话和参与者

控制台说明

  1. 打开 Amazon IVS 控制台。

    （您还可通过 AWS Management Console 访问 Amazon IVS 控制台。）

  2. 在导航窗格中，选择舞台。（如果导航窗格已折叠，请首先选择汉堡包图标以将其打开。）

  3. 选择舞台以跳转至该舞台的详细信息页面。

  4. 向下滚动页面，直到看到舞台会话部分，然后选择一个舞台会话以查看该舞台的详细信息页面。

  5. 要查看会话中的参与者，请向下滚动，直到看到参与者部分，然后选择一个参与者以查看该参与者的详细信息页面，包括 Amazon CloudWatch 指标的图表。

查看参与者的事件

舞台中的参与者状态发生变化（例如加入舞台或在尝试发布到舞台时遇到错误）时，会发送事件。并非所有错误都会导致发生事件；例如，客户端网络错误和令牌签名错误不会作为事件发送。要处理客户端应用程序中的这些错误，请使用 IVS 广播 SDK。

控制台说明

  1. 按照上面的说明导航到参与者详细信息页面。

  2. 向下滚动，直到看到事件部分。此部分将显示参与者事件的有序列表。请参阅将 Amazon EventBridge 与 Amazon IVS 配合使用，了解为参与者发布的事件的详细信息。

CLI 说明

使用 AWS CLI 访问舞台会话事件是一种高级选项，需要先在计算机上下载并配置 CLI。有关详细信息，请参阅 AWS Command Line Interface 用户指南。

  1. 列出所有舞台会话以查找某个舞台会话：

    aws ivs-realtime list-stage-sessions --stage-arn <arn>

  2. 列出某个舞台会话的所有参与者以查找某个参与者：

    aws ivs-realtime list-participants --stage-arn <arn> –session-id <sessionId>

  3. 列出某个舞台会话和参与者的所有事件：

    aws ivs-realtime list-participant-events --stage-arn <arn> --session-id <sessionId> –-participant-id <participantId>

以下为 list-participant-events 调用的示例响应：

{
    "events": [
        {
            "eventTime": "2023-04-04T22:48:41+00:00",
            "name": "JOINED",
            "participantId": "AdRezBl021t0"
        },
        {
            "eventTime": "2023-04-04T22:48:41+00:00",
            "name": "SUBSCRIBE_STARTED",
            "participantId": "AdRezBl021t0",
            "remoteParticipantId": "Ou5b5n5XLMdC"
        },
        {
            "eventTime": "2023-04-04T22:49:45+00:00",
            "name": "SUBSCRIBE_STOPPED",
            "participantId": "AdRezBl021t0",
            "remoteParticipantId": "Ou5b5n5XLMdC"
        },
        {
            "eventTime": "2023-04-04T22:49:45+00:00",
            "name": "LEFT",
            "participantId": "AdRezBl021t0"
        }
    ]
}

访问 CloudWatch 指标

要使 CloudWatch 指标可用，必须使用以下 IVS 广播 SDK 版本：Web 1.5.0 或更高版本、Android 1.12.0 或更高版本、iOS 1.12.0 或更高版本。

CloudWatch 控制台说明

  1. 访问 https://console.aws.amazon.com/cloudwatch/ 打开 CloudWatch 控制台。

  2. 在侧导航栏中，展开 Metrics（指标）下拉菜单，然后选择 All metrics（所有指标）。

  3. 在浏览选项卡上，使用左侧未标记的下拉菜单，选择您的“主”区域，即创建通道的区域。有关区域的详细信息，请参阅全球解决方案，区域控制。有关支持区域的列表，请参阅亚马逊云科技一般参考中的 Amazon IVS 页面。

  4. 在浏览选项卡的底部，选择 IVSRealTime 命名空间。

  5. 执行下列操作之一：

    1. 在搜索栏中，输入资源 ID（是 ARN arn:::ivs:stage/<resource id> 的一部分）。

      然后选择 IVSRealTime > Stage 指标。

    2. 如果 IVSRealTime 显示为 Amazon 命名空间下的一个可选服务，选择该服务。如果您使用 Amazon IVS 实时直播功能并将指标发送给 Amazon CloudWatch，则将会列出 IVS。（如果 IVSRealTime 未列出，则说明您没有任何 Amazon IVS 指标。）

      然后根据需要选择维度分组；可用维度将在下面的 CloudWatch 指标 中列出。

  6. 选择要添加到图表的指标。可用维度将在下面的 CloudWatch 指标 中列出。

您还可以从流会话的详细信息页面访问流会话的 CloudWatch 图表，方法是选择 View in CloudWatch（在 CloudWatch 中查看）按钮。

CLI 说明

您也可以使用 Amazon CLI 访问指标。这需要首先在计算机上下载并配置 CLI。有关详细信息，请参阅 Amazon 命令行界面用户指南。

然后，使用 Amazon CLI 访问 Amazon IVS 实时直播功能指标：

  • 在命令提示符下，运行：

    aws cloudwatch list-metrics --namespace AWS/IVSRealTime

有关更多信息，请参阅 Amazon CloudWatch 用户指南中的使用 Amazon CloudWatch 指标。

CloudWatch 指标：IVS 实时直播功能

Amazon IVS 在 Amazon/IVSRealTime 命名空间中提供了以下指标。

要使 CloudWatch 指标可用，必须使用 Web 广播 SDK 1.5.2 或更高版本。

该维度可能的有效值如下：

  • Stage 维度是一个资源 ID（ARN arn:::stage/<resource id> 的一部分）。

  • Participant 维度是一个 participantID。

  • 对于“video”的 MediaType，SimulcastLayer 为“hi”、“mid”、“low”或“no-rid”，对于“audio”的 MediaType，则为“disabled”。该值也可以为空。

  • MediaType 维度为“视频”或“音频”（字符串）。

指标 维度 说明

DownloadPacketLoss

Stage

每个样本代表给定订阅用户从 IVS 服务器下载时的丢包百分比。

单位：百分比

有效统计数据：平均值、最大值、最小值 –（分别为）在配置的时间间隔内掉帧的平均数、最大数或最小数。

DownloadPacketLoss

Stage,Participant

对于同时也是发布者的订阅用户，按参与者筛选 DownloadPacketLoss。样本代表订阅用户从 IVS 服务器下载时的丢包百分比。仅当参与者同时也是发布者时，才会发出样本。

单位：百分比

有效统计数据：平均值、最大值、最小值 –（分别为）在配置的时间间隔内丢帧的平均数、最大数或最小数。

DroppedFrames

Stage

每个样本代表给定订阅用户的丢帧百分比。

单位：百分比

有效统计数据：平均值、最大值、最小值 –（分别为）在配置的时间间隔内丢帧的平均数、最大数或最小数。

DroppedFrames

Stage,Participant

对于同时也是发布者的订阅用户，按参与者筛选 DroppedFrames。样本表示订阅参与者与舞台中所有发布者之间掉帧的百分比。仅当参与者同时也是发布者时，才会发出样本。

单位：百分比

有效统计数据：平均值、最大值、最小值 –（分别为）在配置的时间间隔内丢帧的平均数、最大数或最小数。

PublishBitrate

Stage

发出的样本表示给定发布者发送视频和音频数据的总速率（所有联播层的总和）。

单位：每秒比特数

有效统计数据：平均值、最大值、最小值 –（分别为）在配置的时间间隔内比特率的平均数、最大数或最小数。

PublishBitrate

Stage, Participant, SimulcastLayer, MediaType

PublishBitrate 按参与者、联播层和媒体类型筛选。联播层 ID 由广播 SDK 设置。禁用联播时，此层 ID 将设置为“已禁用”。媒体类型为视频或音频。

单位：每秒比特数

有效统计数据：平均值、最大值、最小值 –（分别为）在配置的时间间隔内比特率的平均数、最大数或最小数。

Publishers

Stage

发布到舞台的参与者人数。

单位：计数

有效统计数据：平均值、最大值、最小值

PublishResolution

Stage, Participant, SimulcastLayer, MediaType

帧宽和帧高两者中较小者的像素数。例如，对于大小为 1920x1080 的横向帧，PublishResolution 为 1080。对于大小为 720x1280 的竖向帧，PublishResolution 为 720。

单位：计数

有效统计数据：平均值、最大值、最小值

SubscribeBitrate

Stage

发出的样本代表给定订阅用户同时接收视频和音频数据的总速率。

单位：每秒比特数

有效统计数据：平均值、最大值、最小值 –（分别为）在配置的时间间隔内比特率的平均数、最大数或最小数。

SubscribeBitrate

Stage,Participant,MediaType

对于同时也是发布者的订阅用户，按参与者筛选 SubscribeBitrate。样本表示给定订阅用户的接收给定 MediaType 的比特率。仅当订阅参与者发布时才会发出样本。

单位：每秒比特数

有效统计数据：平均值、最大值、最小值 –（分别为）在配置的时间间隔内比特率的平均数、最大数或最小数。

Subscribers

Stage

订阅该舞台的参与者人数。请注意，主动发布和订阅的参与者才被视为发布者和订阅用户。

单位：计数

有效统计数据：平均值、最大值、最小值