Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memantau Streaming Waktu Nyata Amazon IVS
<a name="stage-health"></a>

Dokumen ini memberikan detail tentang opsi yang tersedia untuk memantau aplikasi streaming real-time IVS Anda.

## Apa itu Sesi Panggung?
<a name="stage-health-session"></a>

*Sesi* panggung dimulai ketika peserta pertama bergabung dengan panggung dan berakhir beberapa menit setelah peserta terakhir berhenti menerbitkan ke panggung. Sesi panggung membantu men-debug tahapan berumur panjang dengan memisahkan acara dan peserta menjadi sesi yang berumur pendek.

## Lihat Sesi Panggung dan Peserta
<a name="stage-health-view-sessions-participants"></a>

### Instruksi Konsol
<a name="stage-health-view-sessions-participants-console"></a>

1. Buka [konsol Amazon IVS](https://console.aws.amazon.com/ivs).

   (Anda juga dapat mengakses konsol Amazon IVS melalui [Konsol AWS Manajemen](https://console.aws.amazon.com/).)

1. Pada panel navigasi, pilih **Tahapan**. (Jika panel navigasi diciutkan, buka dulu dengan memilih ikon hamburger.)

1. Pilih panggung untuk pergi ke halaman detailnya.

1. Gulir ke bawah halaman hingga Anda melihat bagian **Sesi panggung**, lalu pilih sesi panggung untuk melihat halaman detailnya.

1. Untuk melihat peserta dalam sesi, gulir ke bawah hingga Anda melihat bagian **Peserta**, lalu pilih peserta untuk melihat halaman detailnya, termasuk bagan untuk CloudWatch metrik Amazon.

## Lihat Acara untuk Peserta
<a name="stage-health-view-participant-events"></a>

Acara dikirim ketika status peserta dalam tahap berubah, seperti bergabung dengan panggung atau mengalami kesalahan saat mencoba mempublikasikan ke panggung. Tidak semua kesalahan menyebabkan peristiwa; misalnya, kesalahan jaringan sisi klien dan kesalahan tanda tangan token tidak dikirim sebagai peristiwa. Untuk menangani kesalahan ini dalam aplikasi klien Anda, gunakan [siaran SDKs IVS](broadcast.md).

### Instruksi Konsol
<a name="stage-health-view-participant-events-console"></a>

1. Arahkan ke halaman detail peserta seperti yang diinstruksikan di atas.

1. Gulir ke bawah hingga Anda melihat bagian **Acara**. Ini menampilkan daftar acara peserta yang diurutkan. Lihat [Menggunakan Amazon EventBridge dengan Amazon IVS](eventbridge.md) untuk detail tentang acara yang dipancarkan untuk peserta.

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

Mengakses acara sesi panggung dengan AWS CLI adalah opsi lanjutan dan mengharuskan Anda mengunduh dan mengonfigurasi CLI terlebih dahulu di mesin Anda. Untuk detailnya, lihat [Panduan Pengguna Antarmuka Baris AWS Perintah](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).

1. Daftar sesi panggung untuk menemukan sesi panggung:

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

1. Daftar peserta untuk sesi panggung untuk menemukan peserta:

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

1. Daftar acara untuk sesi panggung dan peserta:

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

Berikut adalah contoh respons untuk `list-participant-events` panggilan tersebut: 

```
{
    "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 Metrik Akses
<a name="stage-health-access-cloudwatch-metrics"></a>

Agar CloudWatch metrik tersedia, diperlukan versi IVS Broadcast SDK berikut: Web 1.5.0 atau yang lebih baru, Android 1.12.0 atau versi lebih baru, atau iOS 1.12.0 atau yang lebih baru.

### CloudWatch Instruksi Konsol
<a name="stage-health-access-cloudwatch-metrics-console"></a>

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Di navigasi samping, perluas menu tarik-turun **Metrik**, lalu pilih **Semua metrik**.

1. Pada tab **Jelajahi**, menggunakan menu tarik-turun tidak berlabel di sebelah kiri, pilih wilayah “asal” Anda, tempat saluran dibuat. Untuk informasi selengkapnya tentang wilayah, lihat [Solusi Global, Kontrol Regional](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/what-is.html#what-is-aws). Untuk daftar wilayah yang didukung, lihat [Halaman Amazon IVS](https://docs.aws.amazon.com/general/latest/gr/ivs.html) di *Referensi Umum AWS*.

1. Di bagian bawah tab **Browse**, pilih ruang nama **IVSRealTime**.

1. Lakukan salah satu tindakan berikut:

   1. Di bilah pencarian, masukkan ID sumber daya Anda (bagian dari ARN, `arn:::ivs:stage/<resource id>`).

      Kemudian pilih **IVSRealTime > Stage Metrics**.

   1. Jika **IVSRealWaktu** muncul sebagai layanan yang dapat dipilih di bawah **AWS Namespaces**, pilih. Ini akan terdaftar jika Anda menggunakan Amazon IVS Real-Time Streaming dan mengirimkan metrik ke Amazon. CloudWatch (Jika **IVSRealWaktu** tidak terdaftar, Anda tidak memiliki metrik Amazon IVS.)

      Kemudian pilih pengelompokan *dimensi* sesuai keinginan; dimensi yang tersedia tercantum dalam [CloudWatchMetrik](#stage-health-cloudwatch-metrics) di bawah ini.

1. Pilih metrik yang akan ditambahkan ke grafik. Metrik yang tersedia tercantum dalam [CloudWatch Metrik](#stage-health-cloudwatch-metrics) di bawah ini.

Anda juga dapat mengakses CloudWatch bagan sesi streaming Anda dari halaman detail sesi streaming, dengan memilih CloudWatch tombol **Lihat di**.

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

Anda juga dapat mengakses metrik dengan memanfaatkan AWS CLI. Cara ini mengharuskan Anda untuk mengunduh dan mengonfigurasikan CLI terlebih dahulu di mesin. Untuk detail, lihat [Panduan Pengguna AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).

Kemudian, untuk mengakses metrik streaming real-time Amazon IVS menggunakan AWS CLI:
+ Di prompt perintah, jalankan:

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

Untuk informasi selengkapnya, lihat [Menggunakan CloudWatch Metrik](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) *Amazon di Panduan CloudWatch Pengguna Amazon*.

## CloudWatch Metrik: Streaming Waktu Nyata IVS
<a name="stage-health-cloudwatch-metrics"></a>

Amazon IVS menyediakan metrik berikut di ruang nama **AWS/Time IVSReal**.

Agar CloudWatch metrik tersedia, Web Broadcast SDK 1.5.2 atau yang lebih baru harus digunakan.

Dimensi dapat memiliki nilai valid berikut:
+ `Stage`Dimensinya adalah ID sumber daya (bagian dari ARN,`arn:::stage/<resource id>`).
+ `Participant`Dimensinya adalah a`participantID`.
+ `SimulcastLayer`Itu adalah “hi”, “mid”, “low”, atau “none” untuk “video”, atau “none” untuk “audio.” `MediaType` `MediaType` Nilai ini juga bisa kosong.
+ `MediaType`Dimensinya adalah “video” atau “audio” (string).

Dalam hal replikasi peserta, untuk tahap tujuan, metrik tahap-kesehatan yang ada mencakup semua peserta yang direplikasi (penerbit di tahap sumber yang merupakan peserta replika di tahap tujuan).


| Metrik | Dimensi | Deskripsi | 
| --- | --- | --- | 
| `ConcurrentPublishers` | — | Jumlah peserta yang mempublikasikan di semua tahapan di Wilayah AWS.<br />Unit: Jumlah<br />Statistik yang valid: Rata-rata, Maksimum, Minimum | 
| `ConcurrentSubscriptions` | — | Jumlah publisher-to-subscriber koneksi simultan di semua tahapan di Wilayah AWS.<br />Unit: Jumlah<br />Statistik yang valid: Rata-rata, Maksimum, Minimum | 
| `DownloadPacketLoss` | — | Persentase paket yang hilang saat mengunduh dari server IVS oleh pelanggan.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari kehilangan paket selama interval yang dikonfigurasi | 
| `DownloadPacketLoss` | `Platform` | Filter `DownloadPacketLoss` berdasarkan platform pelanggan.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari kehilangan paket selama interval yang dikonfigurasi | 
| `DownloadPacketLoss` | `Platform, SDKVersion` | Filter `DownloadPacketLoss` berdasarkan platform pelanggan dan versi SDK.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari kehilangan paket selama interval yang dikonfigurasi | 
| `DownloadPacketLoss` | `Stage` | Filter `DownloadPacketLoss` berdasarkan tahap pelanggan.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari kehilangan paket selama interval yang dikonfigurasi | 
| `DownloadPacketLoss` | `Stage, Participant` | Filter `DownloadPacketLoss` menurut peserta, untuk pelanggan yang juga penerbit. Sampel mewakili persentase paket yang hilang oleh pelanggan saat mengunduh dari server IVS. Sampel dipancarkan hanya jika peserta juga penerbit.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `DownloadPacketLoss` | `Stage, Platform` | Filter `DownloadPacketLoss` berdasarkan tahap pelanggan dan platform.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari kehilangan paket selama interval yang dikonfigurasi | 
| `DownloadPacketLoss` | `Stage, Platform, SDKVersion` | Filter `DownloadPacketLoss` berdasarkan tahap pelanggan, platform, dan versi SDK.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari kehilangan paket selama interval yang dikonfigurasi | 
| `DownloadPacketLoss` | `Stage, SubscriberCountryCode` | Filter `DownloadPacketLoss` berdasarkan tahap pelanggan dan kode negara (ISO 3166).<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari kehilangan paket selama interval yang dikonfigurasi | 
| `DownloadPacketLoss` | `SubscriberCountryCode` | Filter `DownloadPacketLoss` berdasarkan kode negara pelanggan (ISO 3166).<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari kehilangan paket selama interval yang dikonfigurasi | 
| `DroppedFrames` | `—` | Untuk pelanggan: persentase bingkai video turun, dihitung dengan menggabungkan bingkai yang diterima dan bingkai yang dijatuhkan di semua penerbit tempat pelanggan berlangganan.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `DroppedFrames` | `Platform` | Filter `DroppedFrames` berdasarkan platform pelanggan.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `DroppedFrames` | `Platform, SDKVersion` | Filter `DroppedFrames` berdasarkan platform pelanggan dan versi SDK.<br />Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `DroppedFrames` | `Stage` | Filter `DroppedFrames` berdasarkan tahap.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `DroppedFrames` | `Stage, Participant` | Filter `DroppedFrames` berdasarkan tahap dan peserta. Hanya dipancarkan untuk pelanggan yang juga penerbit.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `DroppedFrames` | `Stage, Platform` | Filter `DroppedFrames` berdasarkan panggung dan platform pelanggan.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `DroppedFrames` | `Stage, Platform, SDKVersion` | Filter `DroppedFrames` berdasarkan tahap dan platform pelanggan dan versi SDK.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `DroppedFrames` | `Stage, SubscriberCountryCode` | Filter `DroppedFrames` berdasarkan tahap dan negara pelanggan.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi  | 
| `DroppedFrames` | `SubscriberCountryCode` | Filter `DroppedFrames` menurut negara pelanggan.<br />Unit: Persen<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari frame yang dijatuhkan selama interval yang dikonfigurasi | 
| `PublishBitrate` | `—` | Tingkat total di mana penerbit mengirim data video dan audio (dijumlahkan di semua lapisan simulcast). Ini termasuk data yang ditransmisikan kembali. Bitrate dapat meningkat dengan kehilangan paket unggah dan transmisi ulang, karena mencerminkan apa yang dikirim penerbit dan mungkin tidak cocok dengan apa yang diterima atau dikirim IVS kepada pelanggan.<br />Bit/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `PublishBitrate` | `Platform` | Filter `PublishBitrate` berdasarkan platform penerbit.<br />Bit/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `PublishBitrate` | `Stage` | Filter `PublishBitrate` berdasarkan tahap.<br />Satuan: Bits/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `PublishBitrate` | `Stage, Participant, SimulcastLayer, MediaType` | Filter `PublishBitrate` berdasarkan tahap, peserta, lapisan simulcast, dan jenis media. ID lapisan simulcast diatur oleh SDK siaran. Ketika simulcast dinonaktifkan, ID lapisan ini akan diatur ke “dinonaktifkan”. Jenis media adalah “video” atau “audio”.<br />Satuan: Bits/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `Publishers` | `Stage` | Jumlah peserta yang mempublikasikan ke panggung.<br />Unit: Jumlah<br />Statistik yang valid: Rata-rata, Maksimum, Minimum | 
| `PublishFramerate` | `Stage, Participant` | Seberapa sering bingkai video diterima dari penerbit tertentu. Metrik ini hanya tersedia untuk peserta yang menerbitkan melalui RTMP.<br />Satuan: Hitung/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) framerate selama interval yang dikonfigurasi | 
| `PublishFramerate` | `Stage, Participant, SimulcastLayer, MediaType` | Seberapa sering bingkai video diterima dari penerbit tertentu. Metrik ini hanya tersedia untuk peserta yang menerbitkan melalui RTMP.<br />Satuan: Hitung/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) framerate selama interval yang dikonfigurasi | 
| `PublishResolution` | `Stage, Participant, SimulcastLayer, MediaType` | Jumlah piksel di bagian yang lebih kecil dari lebar atau tinggi bingkai. Misalnya, untuk bingkai lanskap ukuran 1920x1080, adalah 1080. PublishResolution Untuk bingkai potret ukuran 720x1280, adalah 720. PublishResolution <br />Unit: Jumlah<br />Statistik yang valid: Rata-rata, Maksimum, Minimum | 
| `SubscribeBitrate` | `—` | Tingkat total di mana pelanggan menerima data video dan audio<br />Satuan: Bits/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `SubscribeBitrate` | `Platform` | Filter `SubscribeBitrate` berdasarkan platform pelanggan.<br />Satuan: Bits/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi  | 
| `SubscribeBitrate` | `Platform, SDKVersion` | Filter `SubscribeBitrate` berdasarkan platform pelanggan dan versi SDK.<br />Satuan: Bits/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `SubscribeBitrate` | `Stage` | Filter `SubscribeBitrate` berdasarkan tahap.<br />Satuan: Bits/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `SubscribeBitrate` | `Stage, Participant, MediaType` | Filter `SubscribeBitrate` berdasarkan tahap, peserta, dan jenis media. Jenis media adalah “video” atau “audio”. Metrik ini dipancarkan hanya saat peserta berlangganan juga menerbitkan.<br />Satuan: Bits/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `SubscribeBitrate` | `Stage, Platform` | Filter `SubscribeBitrate` berdasarkan panggung dan platform pelanggan.<br />Bit/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `SubscribeBitrate` | `Stage, Platform, SDKVersion` | Filter `SubscribeBitrate` berdasarkan tahap dan platform pelanggan dan versi SDK.<br />Bit/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `SubscribeBitrate` | `Stage, SubscriberCountryCode` | Filter `SubscribeBitrate` berdasarkan tahap dan kode negara pelanggan.<br />Bit/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi | 
| `SubscribeBitrate` | `SubscriberCountryCode` | Filter `SubscribeBitrate` berdasarkan kode negara pelanggan (ISO 3166-1 alpha-2).<br />Bit/detik<br />Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) bitrate selama interval yang dikonfigurasi  | 
| `Subscribers` | `Stage` | Jumlah peserta yang berlangganan panggung. Perhatikan bahwa peserta yang secara aktif menerbitkan dan berlangganan dihitung sebagai penerbit dan pelanggan.<br />Unit: Jumlah<br />Statistik yang valid: Rata-rata, Maksimum, Minimum |