Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Memantau Streaming Latensi Rendah Amazon IVS
Anda dapat memantau sumber daya Amazon Interactive Video Service (IVS) menggunakan Amazon CloudWatch. CloudWatch mengumpulkan dan memproses data mentah dari Amazon IVS menjadi metrik yang dapat dibaca, mendekati waktu nyata. Statistik ini disimpan selama 15 bulan, sehingga Anda dapat memperoleh perspektif historis tentang kinerja aplikasi atau layanan web Anda. Anda dapat mengatur alarm untuk ambang batas tertentu dan mengirim pemberitahuan atau mengambil tindakan ketika ambang batas tersebut terpenuhi. Untuk detailnya, lihat Panduan CloudWatch Pengguna.
Stempel waktu pada metrik mewakili awal periode di mana data metrik diakumulasikan. Misalnya, Anda mendapatkan jumlah LiveDeliveredTime
metrik per menit 300 detik pada 01:02:00. Ini berarti bahwa video senilai 5 menit disajikan kepada pemirsa selama periode 1 menit dari 01:02:00 hingga 01:02:59.
Untuk metrik yang ditetapkan sebagai resolusi tinggi, titik data pertama muncul beberapa detik setelah streaming dimulai. Kami menyarankan Anda menentukan periode 5 detik saat membuat permintaan metrik. (Lihat Resolusi di Panduan CloudWatch Pengguna Amazon.) Untuk metrik lainnya, data dipancarkan dalam waktu 1 menit dari stempel waktu yang dirujuknya.
Metrik resolusi tinggi digulung dari waktu ke waktu. Resolusi secara efektif menurun seiring bertambahnya usia metrik. Berikut jadwalnya:
-
Metrik 1 detik tersedia selama 3 jam.
-
Metrik 60 detik tersedia selama 15 hari.
-
Metrik 5 menit tersedia selama 63 hari.
-
Metrik 1 jam tersedia selama 455 hari (15 bulan).
Untuk informasi terkini tentang retensi data, cari “periode retensi” di CloudWatch FAQ Amazon
Prasyarat
-
Anda harus memiliki akun AWS dengan izin IAM yang memadai untuk berinteraksi dengan API dan CloudWatch metrik Stream Health. Untuk langkah-langkah spesifik, lihat Memulai Streaming Latensi Rendah IVS.
-
Anda harus membuat saluran dan memulai streaming. Informasi yang relevan ada di Panduan Pengguna Streaming Latensi Rendah IVS:
-
Untuk petunjuk cara membuat saluran, lihat Membuat Saluran di Memulai Streaming Latensi Rendah IVS.
-
Untuk petunjuk tentang memulai streaming, lihat Mengatur Perangkat Lunak Streaming di Memulai Streaming Latensi Rendah IVS.
-
Untuk detail konfigurasi encoder, lihat Konfigurasi Streaming Amazon IVS.
-
Akses Data Sesi Aliran
Dengan menggunakan listStreamSessions
titik akhir, Anda dapat mengakses daftar aliran yang dimiliki saluran hingga 60 hari. Daftar ini dapat mencakup sesi streaming langsung (dilambangkan dengan kosongendTime
).
Anda bisa mendapatkan data sesi untuk aliran tertentu melalui getStreamSession
titik akhir. Jika Anda tidak menentukan streamId
parameter, titik akhir mengembalikan sesi terbaru. Selain itu, Anda dapat memanggil titik akhir secara berkala untuk mendapatkan acara terbaru streaming Anda (hingga 500 terbaru).
Petunjuk Konsol
-
Buka konsol Amazon IVS
. (Anda juga dapat mengakses konsol Amazon IVS melalui AWS Management Console
.) -
Pada panel navigasi, pilih Saluran. (Jika panel navigasi diciutkan, buka dulu dengan memilih ikon hamburger.)
-
Pilih saluran untuk pergi ke halaman detailnya.
-
Gulir ke bawah halaman hingga Anda melihat bagian Sesi Stream.
-
Pilih ID Stream sesi yang ingin Anda akses untuk melihat detail sesinya, termasuk bagan untuk metrik CloudWatch resolusi tinggi Amazon.
Atau, jika satu atau lebih saluran sudah ditayangkan:
-
Buka konsol Amazon IVS
. -
Pada panel navigasi, pilih Saluran langsung. (Jika panel navigasi diciutkan, buka dulu dengan memilih ikon hamburger.)
-
Pilih saluran langsung dari daftar untuk mengakses detail sesi di dalam tampilan terpisah.
Petunjuk AWS SDK
Mengakses data sesi streaming dengan AWS SDK adalah opsi lanjutan dan mengharuskan Anda mengunduh dan mengonfigurasi SDK terlebih dahulu pada aplikasi Anda. Di bawah ini adalah petunjuk untuk AWS SDK yang digunakan JavaScript.
Prasyarat: Untuk menggunakan contoh kode di bawah ini, Anda perlu memuat AWS JavaScript SDK ke dalam aplikasi Anda. Untuk detailnya, lihat Memulai AWS SDK for JavaScript.
// This first call lists up to 50 stream sessions for a given channel. const AWS = require("aws-sdk"); const REGION = 'us-west-2'; let channelArn = USE_YOUR_CHANNEL_ARN_HERE; AWS.config.getCredentials(function(err) { if (err) console.log(err.stack); // credentials not loaded else { console.log("Access key:", AWS.config.credentials.accessKeyId); } }); AWS.config.update({region: REGION}); var ivs = new AWS.IVS(); // List Stream Sessions async function listSessions(arn) { const result = await ivs.listStreamSessions({"channelArn": arn}).promise(); console.log(result.streamSessions); } listSessions(channelArn); // Get Stream Session async function getSession(arn, id) { const result = await ivs.getStreamSession({"channelArn": arn, "streamId": id}).promise(); console.log(result); // This function polls every 3 seconds and prints the latest IVS stream events. setInterval(function(){ console.log(result.streamSession.truncatedEvents); }, 3000); } getSession(channelArn);
Instruksi CLI
Mengakses data sesi streaming 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 Perintah AWS.
-
Daftar sesi aliran:
aws ivs list-stream-sessions --channel-arn <arn>
-
Dapatkan data sesi streaming untuk aliran tertentu menggunakan
streamId
:aws ivs get-stream-session --channel-arn <arn> --stream-id <streamId>
Berikut adalah contoh respons untuk get-stream-session
panggilan tersebut:
{ "streamSession": { "startTime": "2021-10-22T00:03:57+00:00", "streamId": "st-1FQzeLONMT9XTKI43leLSo1", "truncatedEvents": [ { "eventTime": "2021-10-22T00:09:30+00:00", "name": "Session Ended", "type": "IVS Stream State Change" }, { "eventTime": "2021-10-22T00:09:30+00:00", "name": "Stream End", "type": "IVS Stream State Change" }, { "eventTime": "2021-10-22T00:03:57+00:00", "name": "Stream Start", "type": "IVS Stream State Change" }, { "eventTime": "2021-10-22T00:03:50+00:00", "name": "Session Created", "type": "IVS Stream State Change" } ], "endTime": "2021-10-22T00:09:31+00:00", "ingestConfiguration": { "audio": { "channels": 2, "codec": "mp4a.40.2", "sampleRate": 48000, "targetBitrate": 160000 }, "video": { "avcLevel": "4.0", "avcProfile": "Baseline", "codec": "avc1.42C028", "encoder": "obs-output module (libobs version 27.0.1)", "targetBitrate": 3500000, "targetFramerate": 30, "videoHeight": 1080, "videoWidth": 1920 } }, "channel": { "name": "", "ingestEndpoint": "3f234d592b38.global-contribute.live-video.net", "authorized": false, "latencyMode": "LOW", "recordingConfigurationArn": "", "type": "STANDARD", "playbackUrl": "https://3f234d592b38.us-west-2.playback.live-video.net/api/video/v1/us-west-2.991729659840.channel.dY7LsluQX1gV.m3u8", "arn": "arn:aws:ivs:us-west-2:991729659840:channel/dY7LsluQX1gV" } } }
Filter Streams menurut Health
Untuk dengan mudah menemukan aliran mana yang mengalami masalah, Anda dapat menggunakan listStreams
untuk memfilter streaming langsung berdasarkan “kesehatan.”
Petunjuk Konsol
-
Buka konsol Amazon IVS
. (Anda juga dapat mengakses konsol Amazon IVS melalui AWS Management Console
.) -
Pada panel navigasi, pilih Saluran langsung. (Jika panel navigasi diciutkan, buka dulu dengan memilih ikon hamburger.)
-
Pilih bidang pencarian untuk Filter menurut kesehatan.
-
Dalam daftar drop-down, pilih filtering by Health = STARVING.
Setelah memfilter, Anda dapat membuka halaman detail saluran dan memilih sesi streaming langsung saluran, untuk mengakses detail konfigurasi input dan acara streaming.
Instruksi CLI
Menggunakan AWS CLI adalah opsi lanjutan dan mengharuskan Anda mengunduh dan mengonfigurasi CLI terlebih dahulu di mesin Anda. Untuk detailnya, lihat Panduan Pengguna Antarmuka Baris Perintah AWS.
Untuk memfilter aliran berdasarkan kesehatan (mis.STARVING
):
aws ivs list-streams --filter-by health=STARVING
CloudWatch Dimensi Kesehatan untuk ConcurrentStreams
Anda dapat memfilter ConcurrentStreams
berdasarkan spesifikHealth
. Lihat CloudWatch Metrik: Streaming Latensi Rendah IVS.
CloudWatch Metrik Akses
Amazon CloudWatch mengumpulkan dan memproses data mentah dari Amazon IVS menjadi metrik yang dapat dibaca. near-real-time Statistik ini disimpan selama 15 bulan, sehingga Anda dapat memperoleh perspektif historis tentang kinerja aplikasi atau layanan web Anda. Anda dapat mengatur alarm untuk ambang batas tertentu dan mengirim pemberitahuan atau mengambil tindakan ketika ambang batas tersebut terpenuhi. Untuk detailnya, lihat Panduan CloudWatch Pengguna.
Perhatikan bahwa CloudWatch metrik digulung dari waktu ke waktu. Resolusi secara efektif menurun seiring bertambahnya usia metrik. Berikut jadwalnya:
-
Metrik 1 detik tersedia selama 3 jam.
-
Metrik 60 detik tersedia selama 15 hari.
-
Metrik 5 menit tersedia selama 63 hari.
-
Metrik 1 jam tersedia selama 455 hari (15 bulan).
Saat Anda menelepon, getMetricData
Anda dapat menentukan periode 1, 5 (disarankan), 10, 30 atau kelipatan 60 detik untuk metrik resolusi tinggi.
CloudWatch Petunjuk Konsol
-
Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/
. -
Di navigasi samping, perluas dropdown Metrik, lalu pilih Semua metrik.
-
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.
-
Di bagian bawah tab Browse, pilih namespace IVS.
-
Lakukan salah satu dari berikut:
-
Di bilah pencarian, masukkan ID sumber daya Anda (bagian dari ARN,
arn:::ivs:channel/<resource id>
).Kemudian pilih IVS > By Channel.
-
Jika IVS muncul sebagai layanan yang dapat dipilih di bawah AWS Namespaces, pilih layanan tersebut. Ini akan terdaftar jika Anda menggunakan Amazon IVS dan mengirim metrik ke Amazon. CloudWatch (Jika IVS tidak terdaftar, Anda tidak memiliki metrik Amazon IVS.)
Kemudian pilih pengelompokan dimensi sesuai keinginan; dimensi yang tersedia tercantum dalam CloudWatch Metrik di bawah ini.
-
-
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 latensi rendah Amazon IVS menggunakan AWS CLI:
-
Pada prompt perintah, jalankan:
aws cloudwatch list-metrics --namespace AWS/IVS
Untuk informasi selengkapnya, lihat Menggunakan CloudWatch Metrik Amazon di Panduan CloudWatch Pengguna Amazon.
CloudWatchMetrik: Streaming Latensi Rendah IVS
Amazon IVS menyediakan metrik berikut di namespace AWS/IVS.
Metrik | Dimensi | Deskripsi |
---|---|---|
|
Tidak ada |
Hitungan penayangan bersamaan di semua saluran langsung Anda. Tampilan adalah sesi menonton unik yang secara aktif mengunduh atau memutar video. (Untuk definisi yang lebih rinci, lihatGlosarium.) Jika saluran aktif tetapi secara agregat tidak memiliki tampilan, nilai metrik ini adalah 0. Jika tidak ada saluran yang aktif, metrik tidak memiliki titik data. Unit: Jumlah Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari tampilan bersamaan selama interval yang dikonfigurasi. |
|
|
Filter Metrik ini menyediakan data untuk saluran, bukan aliran. Untuk melihat penayangan bersamaan untuk sesi streaming tertentu pada saluran tertentu, evaluasi Unit: Jumlah Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari tampilan bersamaan selama interval yang dikonfigurasi. |
|
Tidak ada |
Hitungan saluran Anda yang streaming langsung. Jika tidak ada saluran yang aktif, metrik ini tidak memiliki titik data. Unit: Jumlah Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) dari aliran bersamaan selama interval yang dikonfigurasi. |
|
|
Filter Unit: Jumlah Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) dari aliran bersamaan untuk spesifik |
|
|
(Metrik resolusi tinggi) Jumlah data audio yang diterima Amazon IVS saat Anda melakukan streaming. Bitrate yang lebih tinggi membutuhkan lebih banyak bandwidth internet yang tersedia. Satuan: Bit per detik Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) dari bitrate audio yang tertelan selama interval yang dikonfigurasi |
|
|
(Metrik resolusi tinggi) Seberapa sering bingkai animasi diterima oleh Amazon IVS saat Anda melakukan streaming. Satuan: Bingkai per detik Statistik yang valid: Rata-rata, Maksimum, Minimum - Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) framerate konsumsi selama interval yang dikonfigurasi |
|
|
(Metrik resolusi tinggi) Jumlah data video yang diterima Amazon IVS saat Anda melakukan streaming. Bitrate yang lebih tinggi membutuhkan lebih banyak bandwidth internet yang tersedia. Bitrate yang lebih tinggi dapat meningkatkan kualitas video, tetapi hanya sampai titik tertentu. Satuan: Bit per detik Statistik yang valid: Rata-rata, Maksimum, Minimum - Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) dari bitrate video yang dicerna selama interval yang dikonfigurasi |
|
|
(Metrik resolusi tinggi) Titik dalam aliran video di mana seluruh bingkai dikirim, bukan hanya perbedaan dari bingkai sebelumnya. Unit: Detik Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau angka terkecil (masing-masing) dari interval keyframe selama interval yang dikonfigurasi |
|
Tidak ada | Total durasi video real-time yang disajikan ke semua pemirsa. Unit: Detik Statistik yang valid: Jumlah |
|
|
Filter Unit: Detik Statistik yang valid: Jumlah |
|
|
Filter Unit: Detik Statistik yang valid: Jumlah |
|
Tidak ada | Durasi streaming video waktu nyata. Unit: Detik Statistik yang valid: Jumlah |
|
|
Filter Unit: Detik Statistik yang valid: Jumlah |
|
Tidak ada | Durasi waktu nyata dari rekaman video. Unit: Detik Statistik yang valid: Jumlah |
|
|
Filter Unit: Detik Statistik yang valid: Jumlah |