監控 Amazon IVS 即時串流 - Amazon IVS
什麼是階段工作階段？檢視階段工作階段和參與者檢視參與者的事件存取 CloudWatch 指標CloudWatch 指標：IVS 即時串流

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

監控 Amazon IVS 即時串流

什麼是階段工作階段？

階段工作階段會在第一個參與者加入階段時開始，並在最後一位參與者停止發布至階段的幾分鐘後結束。階段工作階段透過將事件和參與者分離為短期工作階段，來協助對長期階段進行偵錯。

檢視階段工作階段和參與者

主控台說明

  1. 開啟 Amazon IVS 主控台。

    (您也可以透過 AWS 管理主控台來存取 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. 在 Browse (瀏覽)索引標籤上，使用左側無標籤的下拉式清單，選取建立頻道的「主要」區域。有關區域的更多資訊，請參閱全球解決方案、區域控制。如需支援的區域清單，請參閱 AWS 一般參考中的 Amazon IVS 頁面。

  4. 在 Browse (瀏覽) 索引標籤底部，選取 IVSRealTime 命名空間。

  5. 執行以下任意一項：

    1. 在搜尋列中，輸入您的資源 ID (ARN 的一部分，arn:::ivs:stage/<resource id>)。

      然後選取 IVSRealTime > 階段指標。

    2. 如果 IVSRealTime 在 AWS 命名空間下顯示為可選取的服務，請選取它。如果您使用 Amazon IVS 即時串流功能 並且它正在傳送指標到 Amazon CloudWatch，則將列出它。(如果未列出 IVSRealTime，則您沒有任何 Amazon IVS 指標。)

      然後根據需要選擇維度分組；可用的維度會列在下方的 CloudWatch 指標中。

  6. 選擇要新增到圖表的指標。可用的指標列在 CloudWatch 的指標。

您也可以選取 View in CloudWatch (在 CloudWatch 中檢視) 按鈕，從串流工作階段的詳細資訊頁面存取串流工作階段的 CloudWatch 圖表。

CLI 說明

您也可以使用 AWS CLI 存取指標。這需要在您的機器上先下載並設定 CLI。如需詳細資訊，請參閱 AWS 命令列界面使用者指南。

然後，使用 AWS CLI 存取 Amazon IVS 即時串流功能 指標：

  • 在命令提示中，執行：

    aws cloudwatch list-metrics --namespace AWS/IVSRealTime

如需詳細資訊，請參閱 Amazon CloudWatch 使用者指南中的使用 Amazon CloudWatch 指標。

CloudWatch 指標：IVS 即時串流

Amazon IVS 在 AWS/IVSRealTime 命名空間中提供以下指標。

若要使用 CloudWatch 指標，必須使用網路廣播 SDK 1.5.2 或更新版本。

此維度可以具有以下有效值：

  • Stage 維度是資源 ID (ARN 的一部分,arn:::stage/<resource id>)。

  • Participant 維度是 participantID。

  • SimulcastLayer 為 "hi"、"mid"、"low" 或 "no-rid" (MediaType 為「影片」) 或「已停用」(MediaType 為「音訊」)。此值也可以為空白。

  • 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

已訂閱階段的參加者人數。請注意，主動發布及訂閱的參與者同時被視為發布者和訂閱用戶。

單位：計數

有效統計：平均值、最大值、最小值