# 監控 Amazon IVS 即時串流功能
<a name="stage-health"></a>

本文件提供有關可用於監控 IVS 即時串流應用程式之選項的詳細資訊。

## 什麼是階段工作階段？
<a name="stage-health-session"></a>

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

## 檢視階段工作階段和參與者
<a name="stage-health-view-sessions-participants"></a>

### 主控台說明
<a name="stage-health-view-sessions-participants-console"></a>

1. 開啟 [Amazon IVS 主控台](https://console.aws.amazon.com/ivs)。

   (您也可以透過 [AWS 管理主控台](https://console.aws.amazon.com/)來存取 Amazon IVS 主控台。)

1. 在導覽窗格中，選擇**階段**。(如果導航窗格已折疊，請先選擇漢堡圖示將其展開。)

1. 選擇要前往其詳細資訊頁面的階段。

1. 向下捲動頁面，直到看到**階段工作階段**部分，然後選取階段工作階段以檢視其詳細資訊頁面。

1. 若要檢視工作階段中的參與者，請向下捲動直到您看到**參與者**區段，然後選取參與者以檢視其詳細資訊頁面，包括 Amazon CloudWatch 指標的圖表。

## 檢視參與者的事件
<a name="stage-health-view-participant-events"></a>

當階段中參與者的狀態發生變更 (例如加入階段，或嘗試發布至階段時發生錯誤) 時，則會傳送事件。並非所有錯誤都會導致事件；例如，用戶端網路錯誤和權杖簽章錯誤不會做為事件傳送。若要在用戶端應用程式中處理這些錯誤，請使用 [IVS 廣播 SDK](broadcast.md)。

### 主控台說明
<a name="stage-health-view-participant-events-console"></a>

1. 依照上述指示導覽至參與者詳細資訊頁面。

1. 向下捲動，直到看到**事件**部分。這會顯示參與者事件的排序清單。如需有關為參與者發出的事件詳細資訊，請參閱[搭配使用 Amazon EventBridge 與 Amazon IVS](eventbridge.md)。

### CLI 說明
<a name="stage-health-view-participant-events-cli"></a>

使用 AWS CLI 存取階段工作階段事件是進階選項，需要您先在機器下載並設定 CLI。如需詳細資訊，請參閱 [AWS Command Line Interface 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)。

1. 列出階段工作階段以查找階段工作階段：

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

1. 列出階段工作階段的參與者以查找參與者：

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

1. 列出階段工作階段和參與者的事件：

   ```
   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 指標
<a name="stage-health-access-cloudwatch-metrics"></a>

若要使用 CloudWatch，需要以下 IVS 廣播 SDK 版本：Web 1.5.0 或以上、Android 1.12.0 或以上，或 iOS 1.12.0 或以上。

### CloudWatch 主控台說明
<a name="stage-health-access-cloudwatch-metrics-console"></a>

1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在側邊導覽中，展開 **Metrics** (指標) 下拉式選單，然後選取 **All metrics** (所有指標)。

1. 在 **Browse** (瀏覽)索引標籤上，使用左側無標籤的下拉式清單，選取建立頻道的「主要」區域。有關區域的更多資訊，請參閱[全球解決方案、區域控制](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/what-is.html#what-is-aws)。如需支援的區域清單，請參閱 *AWS 一般參考*中的 [Amazon IVS 頁面](https://docs.aws.amazon.com/general/latest/gr/ivs.html)。

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

1. 執行以下任意一項：

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

      然後選取 **IVSRealTime > 階段指標**。

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

      然後根據需要選擇*維度*分組；可用的維度會列在下方的 [CloudWatch 指標](#stage-health-cloudwatch-metrics)中。

1. 選擇要新增到圖表的指標。下面的 [CloudWatch 指標](#stage-health-cloudwatch-metrics)列出了可用指標。

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

### CLI 說明
<a name="stage-health-access-cloudwatch-metrics-cli"></a>

您也可以使用 AWS CLI 存取指標。這需要在您的機器上先下載並設定 CLI。如需詳細資訊，請參閱 [AWS 命令列界面使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)。

然後，使用 AWS CLI 存取 Amazon IVS 即時串流功能指標：
+ 在命令提示中，執行：

  ```
  aws cloudwatch list-metrics --namespace AWS/IVSRealTime
  ```

如需詳細資訊，請參閱 *Amazon CloudWatch 使用者指南*中的[使用 Amazon CloudWatch 指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)。

## CloudWatch 指標：IVS 即時串流
<a name="stage-health-cloudwatch-metrics"></a>

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

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

此維度可以具有以下有效值：
+ `Stage` 維度是資源 ID (ARN 的一部分,`arn:::stage/<resource id>`)。
+ `Participant` 維度是 `participantID`。
+ 對於「視訊」的 `MediaType`，`SimulcastLayer` 為 "hi"、"mid"、"low" 或 "no-rid"；或對於「音訊」的 `MediaType`，其為 "none")。此值也可以為空白。
+ `MediaType` 維度為「視訊」或「音訊」(字串)。

在使用參與者複寫的情況下，對於目的地舞台，現有的舞台運作狀態指標包括所有複寫的參與者 (來源舞台中的發佈者，也是目的地舞台中的複本參與者)。


| 指標 | 維度 | Description | 
| --- | --- | --- | 
| `ConcurrentPublishers` | — |  在 AWS 區域中所有階段發布的參與者人數。 單位：計數 有效統計資料：平均值、最大值、最小值  | 
| `ConcurrentSubscriptions` | — |  AWS 區域中所有階段允許同時發生的「發布者至訂閱用戶」連線數量。 單位：計數 有效統計資料：平均值、最大值、最小值  | 
| `DownloadPacketLoss` | — |  訂閱用戶從 IVS 伺服器下載時遺失的封包百分比。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內擷取封包遺失的平均數、最大數或最小數 (分別)  | 
| `DownloadPacketLoss` | `Platform` |  依訂閱用戶平台篩選 `DownloadPacketLoss`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內擷取封包遺失的平均數、最大數或最小數 (分別)  | 
| `DownloadPacketLoss` | `Platform, SDKVersion` |  依訂閱用戶平台和 SDK 版本篩選 `DownloadPacketLoss`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內擷取封包遺失的平均數、最大數或最小數 (分別)  | 
| `DownloadPacketLoss` | `Stage` |  依訂閱用戶階段篩選 `DownloadPacketLoss`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內擷取封包遺失的平均數、最大數或最小數 (分別)  | 
| `DownloadPacketLoss` | `Stage, Participant` |  依參與者篩選 `DownloadPacketLoss`，針對也是發布者的訂閱用戶。範例代表訂閱用戶從 IVS 伺服器下載時遺失的封包百分比。只有當參與者也是發布者時，才會發出範例。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `DownloadPacketLoss` | `Stage, Platform` |  依訂閱用戶階段和平台篩選 `DownloadPacketLoss`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內擷取封包遺失的平均數、最大數或最小數 (分別)  | 
| `DownloadPacketLoss` | `Stage, Platform, SDKVersion` |  依訂閱用戶階段、平台和 SDK 版本篩選 `DownloadPacketLoss`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內擷取封包遺失的平均數、最大數或最小數 (分別)  | 
| `DownloadPacketLoss` | `Stage, SubscriberCountryCode` |  依訂閱用戶階段和國家/地區代碼 (ISO 3166) 篩選 `DownloadPacketLoss`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內擷取封包遺失的平均數、最大數或最小數 (分別)  | 
| `DownloadPacketLoss` | `SubscriberCountryCode` |  依訂閱用戶國家/地區代碼 (ISO 3166) 篩選 `DownloadPacketLoss`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內擷取封包遺失的平均數、最大數或最小數 (分別)  | 
| `DroppedFrames` | `—` |  訂閱用戶：捨棄影片影格的百分比，計算方式為彙總訂閱用戶訂閱的所有發布者收到的影格及捨棄的影格。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `DroppedFrames` | `Platform` |  依訂閱用戶平台篩選 `DroppedFrames`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `DroppedFrames` | `Platform, SDKVersion` |  依訂閱用戶平台和 SDK 版本篩選 `DroppedFrames`。 百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `DroppedFrames` | `Stage` |  依階段篩選 `DroppedFrames`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `DroppedFrames` | `Stage, Participant` |  依階段和參與者篩選 `DroppedFrames`。只針對同時是發布者的訂閱用戶發出。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `DroppedFrames` | `Stage, Platform` |  依階段和訂閱用戶平台篩選 `DroppedFrames`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `DroppedFrames` | `Stage, Platform, SDKVersion` |  依階段、訂閱用戶平台和 SDK 版本篩選 `DroppedFrames`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `DroppedFrames` | `Stage, SubscriberCountryCode` |  依階段和訂閱用戶國家/地區篩選 `DroppedFrames`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)   | 
| `DroppedFrames` | `SubscriberCountryCode` |  依訂閱用戶國家/地區篩選 `DroppedFrames`。 單位：百分比 有效統計資料：平均值、最大值、最小值 – 設定間隔內捨棄影格速率的平均數、最大數或最小數 (分別)  | 
| `PublishBitrate` | `—` |  發布者傳送視訊和音訊資料的總速率 (所有 Simulcast 層加總)。這包括重新傳輸的資料。由於此數字反映了發布者傳送的內容，並且可能與 IVS 接收或傳送給訂閱用戶的內容不相符，因此上傳封包遺失和重新傳輸可能會使位元率膨脹。 位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `PublishBitrate` | `Platform` |  依發布者平台篩選 `PublishBitrate`。 位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `PublishBitrate` | `Stage` |  依階段篩選 `PublishBitrate`。 單位：位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `PublishBitrate` | `Stage, Participant, SimulcastLayer, MediaType` |  依階段、參與者、Simulcast 層和媒體類型篩選 `PublishBitrate`。Simulcast 層 ID 是由廣播 SDK 設定。停用 Simulcast 時，此層 ID 將設定為「停用」。媒體類型為 "video" 或 "audio"。 單位：位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `Publishers` | `Stage` |  發布至階段的參與者人數。 單位：計數 有效統計資料：平均值、最大值、最小值  | 
| `PublishFramerate` | `Stage, Participant` |  從指定發布者接收影片影格的頻率。此指標僅適用於透過 RTMP 進行發布的參與者。 單位：個/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內影格速率的平均數、最大數或最小數 (分別)  | 
| `PublishFramerate` | `Stage, Participant, SimulcastLayer, MediaType` |  從指定發布者接收影片影格的頻率。此指標僅適用於透過 RTMP 進行發布的參與者。 單位：個/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內影格速率的平均數、最大數或最小數 (分別)  | 
| `PublishResolution` | `Stage, Participant, SimulcastLayer, MediaType` |  跨越框架寬度或高度較小的像素數。例如，對於尺寸為 1920x1080 的橫向框架，PublishResolution 為 1080。對於尺寸為 720x1280 的縱向框架，PublishResolution 為 720。 單位：計數 有效統計資料：平均值、最大值、最小值  | 
| `SubscribeBitrate` | `—` |  訂閱用戶接收視訊和音訊資料的總速率。 單位：位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `SubscribeBitrate` | `Platform` |  依訂閱用戶平台篩選 `SubscribeBitrate`。 單位：位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)   | 
| `SubscribeBitrate` | `Platform, SDKVersion` |  依訂閱用戶平台和 SDK 版本篩選 `SubscribeBitrate`。 單位：位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `SubscribeBitrate` | `Stage` |  依階段篩選 `SubscribeBitrate`。 單位：位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `SubscribeBitrate` | `Stage, Participant, MediaType` |  依階段、參與者和媒體類型篩選 `SubscribeBitrate`。媒體類型為 "video" 或 "audio"。只有在訂閱參與者也發布時才會發出指標。 單位：位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `SubscribeBitrate` | `Stage, Platform` |  依階段和訂閱用戶平台篩選 `SubscribeBitrate`。 位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `SubscribeBitrate` | `Stage, Platform, SDKVersion` |  依階段、訂閱用戶平台和 SDK 版本篩選 `SubscribeBitrate`。 位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `SubscribeBitrate` | `Stage, SubscriberCountryCode` |  依階段和訂閱用戶國家/地區代碼篩選 `SubscribeBitrate`。 位元/秒 有效統計資料：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)  | 
| `SubscribeBitrate` | `SubscriberCountryCode` |  依訂閱用戶國家/地區代碼 (ISO 3166-1 alpha-2) 篩選 `SubscribeBitrate`。 位元/秒 有效統計數字：平均值、最大值、最小值 – 設定間隔內位元速率的平均數、最大數或最小數 (分別)   | 
| `Subscribers` | `Stage` |  已訂閱階段的參加者人數。請注意，主動發布及訂閱的參與者同時被視為發布者和訂閱用戶。 單位：計數 有效統計：平均值、最大值、最小值  |