Prasyarat Akses Data Sesi Aliran Filter Streams menurut Health CloudWatch Metrik Akses CloudWatch Metrik: Streaming IVS Low-Latency

Memantau Streaming Amazon IVS Low-Latency

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 bisa mendapatkan perspektif historis tentang performa aplikasi atau layanan web Anda. Anda dapat mengatur alarm untuk ambang batas tertentu dan mengirimkan notifikasi atau mengambil tindakan saat 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 menurun secara efektif 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 dengan Low-Latency Streaming IVS.
Anda harus membuat saluran dan memulai streaming. Informasi yang relevan ada di Panduan Pengguna Low-Latency Streaming IVS:
- Untuk petunjuk cara membuat saluran, lihat Membuat Saluran di Memulai Low-Latency Streaming IVS.
- Untuk petunjuk tentang memulai streaming, lihat Mengatur Perangkat Lunak Streaming di Memulai Low-Latency Streaming IVS.
- Untuk detail konfigurasi encoder, lihat Konfigurasi Streaming Amazon IVS.

Akses Data Sesi Aliran

Dengan menggunakan listStreamSessions operasi ini, 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 operasi. Jika Anda tidak menentukan streamId parameter, operasi mengembalikan sesi terbaru. Selain itu, Anda dapat memanggil operasi secara berkala untuk mendapatkan acara terbaru streaming Anda (hingga 500 terbaru).

Instruksi Konsol

Buka konsol Amazon IVS.

(Anda juga dapat mengakses konsol Amazon IVS melalui Konsol Manajemen AWS.)
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.

Instruksi 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 detail, lihat Panduan Pengguna AWS Command Line Interface.

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

Instruksi Konsol

Buka konsol Amazon IVS.

(Anda juga dapat mengakses konsol Amazon IVS melalui Konsol Manajemen AWS.)
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 detail, lihat Panduan Pengguna AWS Command Line Interface.

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 IVS Low-Latency .

CloudWatch Metrik Akses

Amazon CloudWatch mengumpulkan dan memproses data mentah dari Amazon IVS menjadi metrik yang hampir real-time yang dapat dibaca. Statistik ini disimpan selama 15 bulan, sehingga Anda bisa mendapatkan perspektif historis tentang performa aplikasi atau layanan web Anda. Anda dapat mengatur alarm untuk ambang batas tertentu dan mengirimkan notifikasi atau mengambil tindakan saat ambang batas tersebut terpenuhi. Untuk detailnya, lihat Panduan CloudWatch Pengguna.

Perhatikan bahwa CloudWatch metrik digulung dari waktu ke waktu. Resolusi menurun secara efektif 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 Instruksi Konsol

Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.
Di navigasi samping, perluas menu tarik-turun Metrik, lalu pilih Semua metrik.
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. Untuk daftar wilayah yang didukung, lihat Halaman Amazon IVS di Referensi Umum AWS.
Di bagian bawah tab Browse, pilih namespace IVS.
Lakukan salah satu tindakan 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 yang akan 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 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.

Kemudian, untuk mengakses metrik streaming latensi rendah Amazon IVS menggunakan AWS CLI:

Di prompt perintah, jalankan:


aws cloudwatch list-metrics --namespace AWS/IVS

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

CloudWatch Metrik: Streaming IVS Low-Latency

Amazon IVS menyediakan metrik berikut di namespace. AWS/IVS

Metrik	Dimensi	Deskripsi
`ConcurrentViews`	—	Hitungan penayangan bersamaan di semua saluran langsung Anda. Tampilan adalah sesi tampilan unik yang secara aktif mengunduh atau memutar file media. (Untuk definisi yang lebih rinci, lihatGlosarium IVS.) 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`	—	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.
`ConcurrentStreams`	`StreamerCountryCode`	Filter `ConcurrentStreams` menurut negara streamer. Nilai negara adalah kode negara ISO 3166-1 dua karakter. Jika negara streamer tidak dapat ditentukan, itu ditampilkan sebagai TIDAK DIKETAHUI. 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 `StreamerCountryCode` selama interval yang dikonfigurasi.
`IngestAudioBitrate`	`Channel`	(High-resolution metrik) Jumlah data audio yang diterima Amazon IVS saat Anda melakukan streaming. Bitrate yang lebih tinggi membutuhkan lebih banyak bandwidth internet yang tersedia. Satuan: Bits/second 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
`IngestAudioBitrate`	`Channel, Track`	(High-resolution metrik) Jumlah data audio yang diterima Amazon IVS saat Anda melakukan streaming. Bitrate yang lebih tinggi membutuhkan lebih banyak bandwidth internet yang tersedia. Satuan: Bits/second 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
`IngestBitrate`	—	(High-resolution metrik) Jumlah video, audio, dan metadata (dijumlahkan di semua trek) yang diterima Amazon IVS saat Anda melakukan streaming. Bitrate yang lebih tinggi membutuhkan lebih banyak bandwidth internet yang tersedia. Satuan: Bits/second Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) dari bitrate konsumsi selama interval yang dikonfigurasi
`IngestBitrate`	`Channel`	(High-resolution metrik) Jumlah video, audio, dan metadata (dijumlahkan di semua trek) yang diterima Amazon IVS saat Anda melakukan streaming. Bitrate yang lebih tinggi membutuhkan lebih banyak bandwidth internet yang tersedia. Satuan: Bits/second Statistik yang valid: Rata-rata, Maksimum, Minimum — Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) dari bitrate konsumsi selama interval yang dikonfigurasi
`IngestFramerate`	—	(High-resolution metrik) Seberapa sering bingkai video diterima oleh Amazon IVS saat Anda melakukan streaming. Satuan: Count/second Statistik yang valid: Rata-rata, Maksimum, Minimum - Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) framerate konsumsi selama interval yang dikonfigurasi
`IngestFramerate`	`Channel`	(High-resolution metrik) Seberapa sering bingkai video diterima oleh Amazon IVS saat Anda melakukan streaming. Satuan: Count/second Statistik yang valid: Rata-rata, Maksimum, Minimum - Jumlah rata-rata, jumlah terbesar, atau jumlah terkecil (masing-masing) framerate konsumsi selama interval yang dikonfigurasi
`IngestFramerate`	`Channel, Track`	(High-resolution metrik) Seberapa sering bingkai video diterima oleh Amazon IVS saat Anda melakukan streaming. Satuan: Count/second 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`	(High-resolution metrik) 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: Bits/second 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
`IngestVideoBitrate`	`Channel, Track`	(High-resolution metrik) 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: Bits/second 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`	(High-resolution metrik) Titik dalam aliran video di mana seluruh frame dikirim, bukan hanya perbedaan dari frame 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
`KeyframeInterval`	`Channel, Track`	(High-resolution metrik) Titik dalam aliran video di mana seluruh frame dikirim, bukan hanya perbedaan dari frame 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`	—	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`	—	Real-time durasi streaming video. 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`	—	Real-time durasi video yang direkam. 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