Prasyarat Akses Data Sesi Aliran Filter Streams menurut Health CloudWatch Metrik Akses CloudWatchMetrik: Streaming Latensi Rendah IVS

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 menggunakanstreamId:
```
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:
1. Di bilah pencarian, masukkan ID sumber daya Anda (bagian dari ARN,arn:::ivs:channel/<resource id>).
  
  Kemudian pilih IVS > By Channel.
2. 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
`ConcurrentViews`	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.
`ConcurrentViews`	`Channel`	Filter `ConcurrentViews` berdasarkan saluran ARN. Jika saluran aktif tetapi tidak memiliki tampilan, nilai metrik ini adalah 0. Jika saluran tidak aktif, metrik tidak memiliki titik data. Metrik ini menyediakan data untuk saluran, bukan aliran. Untuk melihat penayangan bersamaan untuk sesi streaming tertentu pada saluran tertentu, evaluasi `ConcurrentViews` metrik untuk saluran tersebut antara waktu mulai dan akhir sesi streaming. 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.
`ConcurrentStreams`	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.
`ConcurrentStreams`	`Health`	Filter `ConcurrentStreams` berdasarkan kesehatan saluran. 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 untuk spesifik `Health` selama interval yang dikonfigurasi.
`IngestAudioBitrate`	`Channel`	(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
`IngestFramerate`	`Channel`	(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
`IngestVideoBitrate`	`Channel`	(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
`KeyframeInterval`	`Channel`	(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
`LiveDeliveredTime`	Tidak ada	Total durasi video real-time yang disajikan ke semua pemirsa. Unit: Detik Statistik yang valid: Jumlah
`LiveDeliveredTime`	`Channel`	Filter `LiveDeliveredTime` berdasarkan saluran. Nilai saluran adalah saluran`resource-id`, yang merupakan bagian terakhir dari ARN. Unit: Detik Statistik yang valid: Jumlah
`LiveDeliveredTime`	`Channel`, `ViewerCountryCode`	Filter `LiveDeliveredTime` berdasarkan saluran dan kode negara pemirsa. Nilai saluran adalah saluran`resource-id`, yang merupakan bagian terakhir dari ARN. Nilai negara adalah kode negara ISO 3166-1 dua karakter. Ini memungkinkan Anda untuk menjawab pertanyaan: dari mana pemirsa saya menonton? Jika negara pemirsa tidak dapat ditentukan, itu ditampilkan sebagai`UNKNOWN`. Unit: Detik Statistik yang valid: Jumlah
`LiveInputTime`	Tidak ada	Durasi streaming video waktu nyata. Unit: Detik Statistik yang valid: Jumlah
`LiveInputTime`	`Channel`	Filter `LiveInputTime` berdasarkan saluran. Nilai saluran adalah saluran`resource-id`, yang merupakan bagian terakhir dari ARN. Unit: Detik Statistik yang valid: Jumlah
`RecordedTime`	Tidak ada	Durasi waktu nyata dari rekaman video. Unit: Detik Statistik yang valid: Jumlah
`RecordedTime`	`Channel`	Filter `RecordedTime` berdasarkan saluran. Nilai saluran adalah saluran`resource-id`, yang merupakan bagian terakhir dari ARN. Unit: Detik Statistik yang valid: Jumlah

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Demo

SDK Siaran IVS