Memantau Streaming Waktu Nyata Amazon IVS

Apa itu Sesi Panggung?

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

Instruksi Konsol

1. Buka konsol Amazon IVS.

   (Anda juga dapat mengakses konsol Amazon IVS melalui Konsol AWS Manajemen.)

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

3. Pilih panggung untuk pergi ke halaman detailnya.

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

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

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 SDK siaran IVS.

Instruksi Konsol

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

2. Gulir ke bawah hingga Anda melihat bagian Acara. Ini menampilkan daftar acara peserta yang diurutkan. Lihat Menggunakan Amazon EventBridge dengan Amazon IVS untuk detail tentang acara yang dipancarkan untuk peserta.

Instruksi CLI

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.

1. Daftar sesi panggung untuk menemukan sesi panggung:

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

2. Daftar peserta untuk sesi panggung untuk menemukan peserta:

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

3. 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"
        }
    ]
}

CloudWatchMetrik Akses

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

1. Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

2. Di navigasi samping, perluas dropdown Metrik, lalu pilih Semua metrik.

3. Pada tab Browse, menggunakan dropdown tidak berlabel di sebelah kiri, pilih wilayah “rumah” Anda, tempat saluran Anda dibuat. Untuk informasi lebih lanjut tentang wilayah, lihat Solusi Global, Kontrol Regional. Untuk daftar wilayah yang didukung, lihat halaman Amazon IVS di Referensi Umum AWS.

4. Di bagian bawah tab Browse, pilih RealTime namespace IVS.

5. Lakukan salah satu dari berikut:

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

      Kemudian pilih IVS RealTime > Stage Metrics.

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

      Kemudian pilih pengelompokan dimensi sesuai keinginan; dimensi yang tersedia tercantum dalam CloudWatchMetrik di bawah ini.

6. Pilih metrik untuk ditambahkan ke grafik. Metrik yang tersedia tercantum dalam CloudWatch Metrik 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

Anda juga dapat mengakses metrik menggunakan AWS CLI. Ini mengharuskan Anda mengunduh dan mengonfigurasi CLI terlebih dahulu di mesin Anda. Untuk detailnya, lihat Panduan Pengguna Antarmuka Baris Perintah AWS.

Kemudian, untuk mengakses metrik streaming real-time Amazon IVS menggunakan AWS CLI:

• Pada prompt perintah, jalankan:

  aws cloudwatch list-metrics --namespace AWS/IVSRealTime

Untuk informasi selengkapnya, lihat Menggunakan CloudWatch Metrik Amazon di Panduan CloudWatch Pengguna Amazon.

CloudWatch Metrik: Streaming Waktu Nyata IVS

Amazon IVS menyediakan metrik berikut di namespace RealTimeAWS/IVS.

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

Dimensi dapat memiliki nilai valid berikut:

• StageDimensinya adalah ID sumber daya (bagian dari ARN,arn:::stage/<resource id>).

• ParticipantDimensinya adalah aparticipantID.

• SimulcastLayerItu adalah “hi”, “mid”, “low”, atau “no-rid” untuk “video” atau “dinonaktifkan” untuk “audio.” MediaType MediaType Nilai ini juga bisa kosong.

• MediaTypeDimensinya adalah “video” atau “audio” (string).

Metrik	Dimensi	Deskripsi
DownloadPacketLoss	Stage	Setiap sampel mewakili persentase paket yang hilang oleh pelanggan tertentu saat mengunduh dari server IVS. Satuan: Persen 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. Satuan: Persen 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	Setiap sampel mewakili persentase frame yang dijatuhkan oleh pelanggan tertentu. Satuan: Persen 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 menurut peserta, untuk pelanggan yang juga penerbit. Sampel mewakili persentase frame yang dijatuhkan antara peserta berlangganan dan semua penerbit di panggung. Sampel dipancarkan hanya jika peserta juga penerbit. Satuan: Persen 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	Stage	Sampel yang dipancarkan mewakili tingkat total di mana penerbit tertentu mengirim data video dan audio (dijumlahkan di semua lapisan simulcast). Satuan: Bit per detik 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 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. Satuan: Bit per detik 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. Unit: Jumlah Statistik yang valid: Rata-rata, Maksimum, Minimum
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 Unit: Jumlah Statistik yang valid: Rata-rata, Maksimum, Minimum
SubscribeBitrate	Stage	Sampel yang dipancarkan mewakili tingkat total di mana pelanggan tertentu menerima data video dan audio. Satuan: Bit per detik 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 menurut peserta, untuk pelanggan yang juga penerbit. Sampel mewakili bitrate di mana pelanggan tertentu menerima yang diberikan. MediaType Sampel hanya dipancarkan saat peserta berlangganan menerbitkan. Satuan: Bit per detik 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. Unit: Jumlah Statistik yang valid: Rata-rata, Maksimum, Minimum