Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memantau Aliran Video Amazon Kinesis
Pemantauan merupakan bagian penting dalam menjaga keandalan, ketersediaan, dan kinerja Amazon Kinesis Video Streams AWS dan solusi Anda. Kami menyarankan untuk mengumpulkan data pemantauan dari semua bagian AWS solusi Anda untuk membantu Anda men-debug kegagalan multi-titik, jika terjadi. Sebelum Anda mulai memantau Amazon Kinesis Video Streams, kami sarankan Anda membuat rencana pemantauan yang mencakup jawaban atas pertanyaan-pertanyaan berikut:
+ Apa saja sasaran pemantauan Anda?
+ Sumber daya apa yang akan Anda pantau?
+ Seberapa sering Anda akan memantau sumber daya ini?
+ Alat pemantauan apa yang akan Anda gunakan?
+ Siapa yang akan melakukan tugas pemantauan?
+ Siapa yang harus diberi tahu saat terjadi kesalahan?
Setelah Anda menentukan sasaran pemantauan dan membuat rencana pemantauan, langkah selanjutnya adalah menetapkan dasar untuk kinerja Amazon Kinesis Video Streams normal di lingkungan Anda. Anda harus mengukur kinerja Amazon Kinesis Video Streams pada berbagai waktu dan dalam kondisi pemuatan yang berbeda. Saat Anda memantau Amazon Kinesis Video Streams, simpan riwayat data pemantauan yang telah Anda kumpulkan. Anda dapat membandingkan kinerja Amazon Kinesis Video Streams saat ini dengan data historis ini untuk membantu Anda mengidentifikasi pola kinerja normal dan anomali kinerja, serta merancang metode untuk mengatasi masalah yang mungkin timbul.
**Topics**
+ [Pantau metrik Amazon Kinesis Video Streams dengan CloudWatch](monitoring-cloudwatch.md)
+ [Pantau Agen Edge Streams Video Amazon Kinesis dengan CloudWatch](monitoring-edge-cloudwatch.md)
+ [Log panggilan API Amazon Kinesis Video Streams dengan AWS CloudTrail](monitoring-cloudtrail.md)
# Pantau metrik Amazon Kinesis Video Streams dengan CloudWatch
Anda dapat memantau aliran video Kinesis menggunakan Amazon CloudWatch, yang mengumpulkan dan memproses data mentah dari Amazon Kinesis Video Streams menjadi metrik hampir real-time yang dapat dibaca. Statistik ini dicatat untuk jangka waktu 15 bulan sehingga Anda dapat mengakses informasi historis dan mendapatkan perspektif yang lebih baik tentang kinerja aplikasi atau layanan web Anda.
Di konsol [Amazon Kinesis Video](https://console.aws.amazon.com//kinesisvideo/home/) Streams, Anda CloudWatch dapat melihat metrik untuk streaming video Amazon Kinesis dengan dua cara:
+ Di halaman **Dasbor**, pilih tab **Streaming video** di bagian **Metrik tingkat akun untuk Wilayah Saat Ini**.
+ Pilih tab **Pemantauan** di halaman detail aliran video.
Amazon Kinesis Video Streams menyediakan metrik berikut:
| Metrik | Deskripsi |
| --- | --- |
| ArchivedFragmentsConsumed.Media | Jumlah titik kuota media fragmen yang dikonsumsi oleh semua pihak. APIs Untuk penjelasan tentang konsep poin kuota, lihat[Kuota fragmen-metadata dan fragmen-media](limits.md#fragment_based_throttling).Unit: Hitungan |
| ArchivedFragmentsConsumed.Metadata | Jumlah fragmen metadata poin kuota yang dikonsumsi oleh semua. APIs Untuk penjelasan konsep poin kuota, lihat[Kuota fragmen-metadata dan fragmen-media](limits.md#fragment_based_throttling).Unit: Hitungan |
| `PutMedia.Requests` | Jumlah permintaan `PutMedia` API untuk aliran tertentu. Unit: Hitungan |
| `PutMedia.IncomingBytes` | Jumlah byte yang diterima sebagai bagian dari `PutMedia` aliran. Unit: Byte |
| `PutMedia.IncomingFragments` | Jumlah fragmen lengkap yang diterima sebagai bagian dari `PutMedia` aliran. Unit: Hitungan |
| `PutMedia.IncomingFrames` | Jumlah frame lengkap yang diterima sebagai bagian dari `PutMedia` aliran. Unit: Hitungan |
| `PutMedia.ActiveConnections` | Jumlah total koneksi ke host layanan. Unit: Hitungan |
| `PutMedia.ConnectionErrors` | Kesalahan saat membuat `PutMedia` koneksi untuk aliran. Unit: Hitungan |
| `PutMedia.FragmentIngestionLatency` | Perbedaan waktu antara saat byte pertama dan terakhir dari sebuah fragmen diterima oleh Amazon Kinesis Video Streams. Unit: Milidetik |
| `PutMedia.FragmentPersistLatency` | Waktu yang diambil dari saat data fragmen lengkap diterima dan diarsipkan. Unit: Hitungan |
| `PutMedia.Latency` | Perbedaan waktu antara permintaan dan respons HTTP dari InletService saat membuat koneksi. Unit: Hitungan |
| `PutMedia.BufferingAckLatency` | Perbedaan waktu antara saat byte pertama dari fragmen baru diterima oleh Amazon Kinesis Video Streams dan ketika Buffering ACK dikirim untuk fragmen. Unit: Milidetik |
| `PutMedia.ReceivedAckLatency` | Perbedaan waktu antara saat byte terakhir dari fragmen baru diterima oleh Amazon Kinesis Video Streams dan ketika ACK Diterima dikirim untuk fragmen. Unit: Milidetik |
| `PutMedia.PersistedAckLatency` | Perbedaan waktu antara saat byte terakhir dari fragmen baru diterima oleh Amazon Kinesis Video Streams dan ketika ACK Persisted dikirim untuk fragmen. Unit: Milidetik |
| `PutMedia.ErrorAckCount` | Jumlah Kesalahan yang ACKs dikirim saat melakukan `PutMedia` streaming. Unit: Hitungan |
| `PutMedia.Success` | 1 untuk setiap fragmen berhasil ditulis; 0 untuk setiap fragmen yang gagal. Nilai rata-rata metrik ini menunjukkan berapa banyak fragmen lengkap dan valid yang dikirim. Unit: Hitungan |
| `GetMedia.Requests` | Jumlah permintaan `GetMedia` API untuk aliran tertentu. Unit: Hitungan |
| `GetMedia.OutgoingBytes` | Jumlah total byte yang dikirim keluar dari layanan sebagai bagian dari `GetMedia` API untuk aliran tertentu. Unit: Byte |
| `GetMedia.OutgoingFragments` | Jumlah fragmen yang dikirim saat melakukan `GetMedia` untuk aliran. Unit: Hitungan |
| `GetMedia.OutgoingFrames` | Jumlah frame yang dikirim selama `GetMedia` pada aliran yang diberikan. Unit: Hitungan |
| `GetMedia.MillisBehindNow` | Perbedaan waktu antara stempel waktu server saat ini dan stempel waktu server dari fragmen terakhir yang dikirim. Unit: Milidetik |
| `GetMedia.ConnectionErrors` | Jumlah koneksi yang tidak berhasil dibuat. Unit: Hitungan |
| `GetMedia.Success` | 1 untuk setiap fragmen berhasil dikirim; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetMediaForFragmentList.OutgoingBytes` | Jumlah total byte yang dikirim keluar dari layanan sebagai bagian dari `GetMediaForFragmentList` API untuk aliran tertentu. Unit: Byte |
| `GetMediaForFragmentList.OutgoingFragments` | Jumlah total fragmen yang dikirim keluar dari layanan sebagai bagian dari `GetMediaForFragmentList` API untuk aliran tertentu. Unit: Hitungan |
| `GetMediaForFragmentList.OutgoingFrames` | Jumlah total frame yang dikirim keluar dari layanan sebagai bagian dari `GetMediaForFragmentList` API untuk aliran tertentu. Unit: Hitungan |
| `GetMediaForFragmentList.Requests` | Jumlah permintaan `GetMediaForFragmentList` API untuk aliran tertentu. Unit: Hitungan |
| `GetMediaForFragmentList.Success` | 1 untuk setiap fragmen berhasil dikirim; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `ListFragments.Latency` | Latensi `ListFragments` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `ListFragments.Requests` | Jumlah permintaan `ListFragments` API untuk aliran tertentu. Unit: Hitungan |
| `ListFragments.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetHLSStreamingSessionURL.Latency` | Latensi `GetHLSStreamingSessionURL` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `GetHLSStreamingSessionURL.Requests` | Jumlah permintaan `GetHLSStreamingSessionURL` API untuk aliran tertentu. Unit: Hitungan |
| `GetHLSStreamingSessionURL.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetHLSMasterPlaylist.Latency` | Latensi `GetHLSMasterPlaylist` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `GetHLSMasterPlaylist.Requests` | Jumlah permintaan `GetHLSMasterPlaylist` API untuk aliran tertentu. Unit: Hitungan |
| `GetHLSMasterPlaylist.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetHLSMediaPlaylist.Latency` | Latensi `GetHLSMediaPlaylist` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `GetHLSMediaPlaylist.Requests` | Jumlah permintaan `GetHLSMediaPlaylist` API untuk aliran tertentu. Unit: Hitungan |
| `GetHLSMediaPlaylist.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetMP4InitFragment.Latency` | Latensi `GetMP4InitFragment` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `GetMP4InitFragment.Requests` | Jumlah permintaan `GetMP4InitFragment` API untuk aliran tertentu. Unit: Hitungan |
| `GetMP4InitFragment.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetMP4MediaFragment.Latency` | Latensi `GetMP4MediaFragment` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `GetMP4MediaFragment.Requests` | Jumlah permintaan `GetMP4MediaFragment` API untuk aliran tertentu. Unit: Hitungan |
| `GetMP4MediaFragment.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetMP4MediaFragment.OutgoingBytes` | Jumlah total byte yang dikirim keluar dari layanan sebagai bagian dari `GetMP4MediaFragment` API untuk aliran tertentu. Unit: Byte |
| `GetTSFragment.Latency` | Latensi `GetTSFragment` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `GetTSFragment.Requests` | Jumlah permintaan `GetTSFragment` API untuk aliran tertentu. Unit: Hitungan |
| `GetTSFragment.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetTSFragment.OutgoingBytes` | Jumlah total byte yang dikirim keluar dari layanan sebagai bagian dari `GetTSFragment` API untuk aliran tertentu. Unit: Byte |
| `GetDASHStreamingSessionURL.Latency` | Latensi `GetDASHStreamingSessionURL` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `GetDASHStreamingSessionURL.Requests` | Jumlah permintaan `GetDASHStreamingSessionURL` API untuk aliran tertentu. Unit: Hitungan |
| `GetDASHStreamingSessionURL.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetDASHManifest.Latency` | Latensi `GetDASHManifest` API memanggil nama aliran yang diberikan. Unit: Milidetik |
| `GetDASHManifest.Requests` | Jumlah permintaan `GetDASHManifest` API untuk aliran tertentu. Unit: Hitungan |
| `GetDASHManifest.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetClip.Latency` | Latensi GetClip API memanggil nama streaming video yang diberikan. Unit: Milidetik |
| `GetClip.Requests` | Jumlah permintaan GetClip API untuk streaming video tertentu. Unit: Hitungan |
| `GetClip.Success` | 1 untuk setiap permintaan yang berhasil; 0 untuk setiap kegagalan. Nilai rata-rata menunjukkan tingkat keberhasilan. Kegagalan mencakup 400 kesalahan (pengguna) dan kesalahan 500 (sistem). Untuk informasi selengkapnya tentang mengaktifkan ringkasan permintaan dan tanggapan, termasuk AWS permintaan IDs, lihat [Pencatatan Ringkasan Permintaan/Respons](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unit: Hitungan |
| `GetClip.OutgoingBytes` | Jumlah total byte yang dikirim keluar dari layanan sebagai bagian dari GetClip API untuk streaming video tertentu. Unit: Byte |
## CloudWatch panduan metrik
CloudWatch metrik dapat membantu menemukan jawaban atas pertanyaan-pertanyaan berikut:
**Topics**
+ [Apakah data mencapai layanan Amazon Kinesis Video Streams?](#monitoring-cloudwatch-guidance-incoming)
+ [Mengapa data tidak berhasil dicerna oleh layanan Amazon Kinesis Video Streams?](#monitoring-cloudwatch-guidance-errors)
+ [Mengapa data tidak dapat dibaca dari layanan Amazon Kinesis Video Streams dengan kecepatan yang sama seperti yang dikirim dari produser?](#monitoring-cloudwatch-guidance-rate)
+ [Mengapa tidak ada video di konsol, atau mengapa video diputar dengan penundaan?](#monitoring-cloudwatch-guidance-novideo)
+ [Apa keterlambatan dalam membaca data waktu nyata, dan mengapa klien tertinggal di belakang kepala aliran?](#monitoring-cloudwatch-guidance-delay)
+ [Apakah klien membaca data keluar dari aliran video Kinesis, dan pada tingkat berapa?](#monitoring-cloudwatch-guidance-isread)
+ [Mengapa klien tidak dapat membaca data dari aliran video Kinesis?](#monitoring-cloudwatch-guidance-noread)
### Apakah data mencapai layanan Amazon Kinesis Video Streams?
**Metrik yang relevan:**
+ `PutMedia.IncomingBytes`
+ `PutMedia.IncomingFragments`
+ `PutMedia.IncomingFrames`
**Item tindakan:**
+ Jika ada penurunan dalam metrik ini, periksa apakah aplikasi Anda masih mengirim data ke layanan.
+ Periksa bandwidth jaringan. Jika bandwidth jaringan Anda tidak mencukupi, itu bisa memperlambat laju layanan menerima data.
### Mengapa data tidak berhasil dicerna oleh layanan Amazon Kinesis Video Streams?
**Metrik yang relevan:**
+ `PutMedia.Requests`
+ `PutMedia.ConnectionErrors`
+ `PutMedia.Success`
+ `PutMedia.ErrorAckCount`
**Item tindakan:**
+ Jika ada peningkatan`PutMedia.ConnectionErrors`, lihat respons HTTP dan kode kesalahan yang diterima oleh klien produsen untuk melihat kesalahan apa yang terjadi saat membuat koneksi.
+ Jika ada penurunan `PutMedia.Success` atau peningkatan`PutMedia.ErrorAckCount`, lihat kode kesalahan ack dalam respons ack yang dikirim oleh layanan untuk melihat mengapa konsumsi data gagal. Untuk informasi selengkapnya, lihat [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html).
### Mengapa data tidak dapat dibaca dari layanan Amazon Kinesis Video Streams dengan kecepatan yang sama seperti yang dikirim dari produser?
**Metrik yang relevan:**
+ `PutMedia.FragmentIngestionLatency`
+ `PutMedia.IncomingBytes`
**Item tindakan:**
+ Jika ada penurunan dalam metrik ini, periksa bandwidth jaringan koneksi Anda. Koneksi bandwidth rendah dapat menyebabkan data mencapai layanan pada tingkat yang lebih rendah.
### Mengapa tidak ada video di konsol, atau mengapa video diputar dengan penundaan?
**Metrik yang relevan:**
+ `PutMedia.FragmentIngestionLatency`
+ `PutMedia.FragmentPersistLatency`
+ `PutMedia.Success`
+ `ListFragments.Latency`
+ `PutMedia.IncomingFragments`
**Item tindakan:**
+ Jika ada peningkatan `PutMedia.FragmentIngestionLatency` atau penurunan`PutMedia.IncomingFragments`, periksa bandwidth jaringan dan apakah data masih dikirim.
+ Jika ada penurunan`PutMedia.Success`, periksa kode kesalahan ack. Untuk informasi selengkapnya, lihat [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html).
+ Jika ada peningkatan `PutMedia.FragmentPersistLatency` atau`ListFragments.Latency`, kemungkinan besar Anda mengalami masalah layanan. Jika kondisi berlanjut untuk jangka waktu yang lama, tanyakan kepada kontak layanan pelanggan Anda untuk melihat apakah ada masalah dengan layanan Anda.
### Apa keterlambatan dalam membaca data waktu nyata, dan mengapa klien tertinggal di belakang kepala aliran?
**Metrik yang relevan:**
+ `GetMedia.MillisBehindNow`
+ `GetMedia.ConnectionErrors`
+ `GetMedia.Success`
**Item tindakan:**
+ Jika ada peningkatan`GetMedia.ConnectionErrors`, maka konsumen mungkin tertinggal dalam membaca aliran, karena seringnya upaya untuk terhubung kembali ke aliran. Lihat response/error kode HTTP yang dikembalikan untuk `GetMedia` permintaan tersebut.
+ Jika ada penurunan`GetMedia.Success`, kemungkinan karena layanan tidak dapat mengirim data ke konsumen, yang akan mengakibatkan koneksi terputus, dan terhubung kembali dari konsumen, yang akan mengakibatkan konsumen tertinggal di belakang kepala aliran.
+ Jika ada peningkatan`GetMedia.MillisBehindNow`, lihat batas bandwidth Anda untuk melihat apakah Anda menerima data pada tingkat yang lebih lambat karena bandwidth yang lebih rendah.
### Apakah klien membaca data keluar dari aliran video Kinesis, dan pada tingkat berapa?
**Metrik yang relevan:**
+ `GetMedia.OutgoingBytes`
+ `GetMedia.OutgoingFragments`
+ `GetMedia.OutgoingFrames`
+ `GetMediaForFragmentList.OutgoingBytes`
+ `GetMediaForFragmentList.OutgoingFragments`
+ `GetMediaForFragmentList.OutgoingFrames`
**Item tindakan:**
+ Metrik ini menunjukkan tingkat di mana data real-time dan arsip sedang dibaca.
### Mengapa klien tidak dapat membaca data dari aliran video Kinesis?
**Metrik yang relevan:**
+ `GetMedia.ConnectionErrors`
+ `GetMedia.Success`
+ `GetMediaForFragmentList.Success`
+ `PutMedia.IncomingBytes`
**Item tindakan:**
+ Jika ada peningkatan`GetMedia.ConnectionErrors`, lihat respons HTTP dan kode kesalahan yang dikembalikan oleh `GetMedia` permintaan. Untuk informasi selengkapnya, lihat [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html).
+ Jika Anda mencoba membaca data terbaru atau langsung, periksa `PutMedia.IncomingBytes` untuk melihat apakah ada data yang masuk ke aliran untuk layanan yang akan dikirim ke konsumen.
+ Jika ada penurunan `GetMedia.Success` atau`GetMediaForFragmentList.Success`, kemungkinan karena layanan tidak dapat mengirim data ke konsumen. Jika kondisi berlanjut untuk jangka waktu yang lama, tanyakan kepada kontak layanan pelanggan Anda untuk melihat apakah ada masalah dengan layanan Anda.
# Pantau Agen Edge Streams Video Amazon Kinesis dengan CloudWatch
Anda dapat memantau Agen Edge Amazon Kinesis Video Streams menggunakan CloudWatch Amazon, yang mengumpulkan dan memproses data mentah menjadi metrik hampir real-time yang dapat dibaca. Statistik ini dicatat untuk jangka waktu 15 bulan. Dengan informasi historis ini, Anda dapat memperoleh perspektif yang lebih baik tentang kinerja aplikasi web atau Amazon Kinesis Video Streams Edge Agent.
Untuk melihat metrik, lakukan hal berikut:
1. Masuk ke Konsol Manajemen AWS dan buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di navigasi kiri, di bawah **Metrik**, pilih **Semua Metrik**.
1. Pilih tab **Browse**, lalu pilih namespace **EdgeRuntimeAgent**khusus.
Amazon Kinesis Video Streams Edge Agent menerbitkan metrik berikut di bawah namespace: `EdgeRuntimeAgent`
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kinesisvideostreams/latest/dg/monitoring-edge-cloudwatch.html)
## CloudWatch panduan metrik untuk Agen Edge Streams Amazon Kinesis Video Streams
CloudWatch metrik dapat berguna untuk menemukan jawaban atas pertanyaan-pertanyaan berikut:
**Topics**
+ [Apakah Agen Edge Streams Video Amazon Kinesis memiliki cukup ruang untuk merekam?](#monitoring-edge-space)
+ [Apakah Agen Edge Streams Video Amazon Kinesis masih hidup?](#monitoring-edge-alive)
+ [Apakah ada pekerjaan yang tidak sehat?](#monitoring-edge-unhealthy)
+ [Apakah ada pekerjaan yang membutuhkan intervensi eksternal?](#monitoring-edge-intervention)
### Apakah Agen Edge Streams Video Amazon Kinesis memiliki cukup ruang untuk merekam?
**Metrik yang relevan:** `PercentageSpaceUsed`
**Tindakan:** Tidak ada tindakan yang diperlukan.
### Apakah Agen Edge Streams Video Amazon Kinesis masih hidup?
**Metrik yang relevan:** `Alive`
**Tindakan:** Jika suatu saat Anda berhenti menerima metrik ini, itu berarti **Agen Tepi Amazon Kinesis Video Streams menemukan satu** atau beberapa hal berikut:
+ Masalah runtime aplikasi: memori atau kendala sumber daya lainnya, bug, dan sebagainya
+ AWS IoT Perangkat yang dijalankan agen saat shutdown, crash, atau dihentikan
+ AWS IoT Perangkat tidak memiliki konektivitas jaringan
### Apakah ada pekerjaan yang tidak sehat?
**Metrik yang relevan:**
+ `RecordJobs.UnhealthyJobCount`
+ `UploadJobs.UnhealthyJobCount`
**Tindakan:** Periksa log dan cari `FatalError` metrik.
+ Jika `FatalError` metrik **ada**, kesalahan fatal ditemukan dan Anda perlu me-restart pekerjaan secara manual. Periksa log dan perbaiki masalah sebelum menggunakan `StartEdgeConfigurationUpdate` untuk memulai ulang pekerjaan secara manual.
+ Jika `FatalError` metrik **tidak** ada, kesalahan sementara (non-fatal) ditemukan dan Amazon Kinesis Video Streams Edge Agent mencoba kembali pekerjaan tersebut.
**catatan**
Agar agen mencoba kembali pekerjaan yang salah, gunakan. [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md)
### Apakah ada pekerjaan yang membutuhkan intervensi eksternal?
**Metrik yang relevan:**
+ `PercentageSpaceUsed`— Jika ini melebihi nilai tertentu, pekerjaan rekaman dijeda dan dilanjutkan hanya ketika ruang tersedia (ketika media keluar dari retensi). Anda dapat mengirim konfigurasi yang diperbarui dengan yang lebih tinggi `MaxLocalMediaSizeInMB` untuk segera memperbarui pekerjaan.
+ `RecordJob.FatalError`/`UploadJob.FatalError`— Selidiki log agen dan kirim konfigurasi lagi agar pekerjaan dapat dilanjutkan.
**Tindakan:** Lakukan panggilan API dengan konfigurasi untuk memulai ulang pekerjaan yang mengalami masalah ini.
# Log panggilan API Amazon Kinesis Video Streams dengan AWS CloudTrail
Amazon Kinesis Video Streams AWS CloudTrail berfungsi dengan, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, Layanan AWS atau di Amazon Kinesis Video Streams. CloudTrail menangkap semua panggilan API untuk Amazon Kinesis Video Streams sebagai peristiwa. Panggilan yang diambil termasuk panggilan dari konsol Amazon Kinesis Video Streams dan panggilan kode ke operasi API Amazon Kinesis Video Streams. Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail acara secara terus menerus ke bucket Amazon S3, termasuk acara untuk Amazon Kinesis Video Streams. Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam **Riwayat acara**. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat untuk Amazon Kinesis Video Streams, alamat IP dari mana permintaan dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan.
Untuk mempelajari selengkapnya CloudTrail, termasuk cara mengonfigurasi dan mengaktifkannya, lihat *[Panduan AWS CloudTrail Pengguna](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)*.
## Amazon Kinesis Video Streams dan CloudTrail
CloudTrail diaktifkan di AWS akun Anda saat Anda membuat akun. Ketika aktivitas peristiwa yang didukung terjadi di Amazon Kinesis Video Streams, aktivitas tersebut direkam CloudTrail dalam suatu peristiwa bersama AWS dengan peristiwa layanan lainnya dalam riwayat **Acara**. Anda dapat melihat, mencari, dan mengunduh acara terbaru di AWS akun Anda. Untuk informasi selengkapnya, lihat [Melihat Acara dengan Riwayat CloudTrail Acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Untuk catatan peristiwa yang sedang berlangsung di AWS akun Anda, termasuk acara untuk Amazon Kinesis Video Streams, buat jejak. *Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, saat Anda membuat jejak di konsol, jejak tersebut berlaku untuk semua Wilayah AWS. Jejak mencatat peristiwa dari semua Wilayah di AWS partisi dan mengirimkan file log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi lainnya Layanan AWS untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat berikut:
+ [Gambaran Umum untuk Membuat Jejak](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Layanan dan Integrasi yang Didukung](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Mengkonfigurasi Notifikasi Amazon SNS untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Menerima File CloudTrail Log dari Beberapa Wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima File CloudTrail Log dari Beberapa Akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Amazon Kinesis Video Streams mendukung pencatatan tindakan berikut sebagai CloudTrail peristiwa dalam file log:
+ [CreateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_CreateStream.html)
+ [DeleteStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html)
+ [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)
+ [GetDataEndpoint](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_GetDataEndpoint.html)
+ [ListStreams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html)
+ [ListTagsForStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListTagsForStream.html)
+ [TagStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_TagStream.html)
+ [UntagStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UntagStream.html)
+ [UpdateDataRetention](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UpdateDataRetention.html)
+ [UpdateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UpdateStream.html)
Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan hal berikut ini:
+ Apakah permintaan dibuat dengan root atau kredensi pengguna
+ Baik permintaan tersebut dibuat dengan kredensial keamanan sementara untuk peran atau pengguna gabungan
+ Apakah permintaan tersebut dibuat oleh Layanan AWS lain.
Untuk informasi lain, lihat [Elemen userIdentity CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Contoh: Entri file log Amazon Kinesis Video Streams
Trail adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Sebuah kejadian mewakili permintaan tunggal dari sumber apa pun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. Berkas log CloudTrail bukan merupakan jejak tumpukan terurut dari panggilan API publik, sehingga tidak muncul dalam urutan tertentu.
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan [CreateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_CreateStream.html)tindakan.
```
{
"Records": [
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25T00:16:31Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "CreateStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream",
"dataRetentionInHours": 2,
"mediaType": "mediaType",
"kmsKeyId": "arn:aws:kms::us-east-1:123456789012:alias",
"deviceName": "my-device"
},
"responseElements": {
"streamARN":arn:aws:kinesisvideo:us-east-1:123456789012:stream/VideoStream/12345"
},
"requestID": "db6c59f8-c757-11e3-bc3b-57923b443c1c",
"eventID": "b7acfcd0-6ca9-4ee1-a3d7-c4e8d420d99b"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25:17:06Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "DeleteStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamARN": "arn:aws:kinesisvideo:us-east-1:012345678910:stream/VideoStream/12345",
"currentVersion": "keqrjeqkj9"
},
"responseElements": null,
"requestID": "f0944d86-c757-11e3-b4ae-25654b1d3136",
"eventID": "0b2f1396-88af-4561-b16f-398f8eaea596"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2014-04-19T00:15:02Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "DescribeStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream"
},
"responseElements": null,
"requestID": "a68541ca-c757-11e3-901b-cbcfe5b3677a",
"eventID": "22a5fb8f-4e61-4bee-a8ad-3b72046b4c4d"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2014-04-19T00:15:03Z",
"eventSource": "kinesisvideo.amazonaws.com",
"eventName": "GetDataEndpoint",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream",
"aPIName": "LIST_FRAGMENTS"
"
},
"responseElements": null,
"requestID": "a6e6e9cd-c757-11e3-901b-cbcfe5b3677a",
"eventID": "dcd2126f-c8d2-4186-b32a-192dd48d7e33"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25T00:16:56Z",
"eventSource": "kinesisvideo.amazonaws.com",
"eventName": "ListStreams",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"maxResults": 100,
"streamNameCondition": {"comparisonValue":"MyVideoStream" comparisonOperator":"BEGINS_WITH"}}
},
"responseElements": null,
"requestID": "e9f9c8eb-c757-11e3-bf1d-6948db3cd570",
"eventID": "77cf0d06-ce90-42da-9576-71986fec411f"
}
]
}
```