Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasi MediaTailor dengan MediaPackage dan CDN
AWS Elemental MediaTailor terintegrasi dengan AWS Elemental MediaPackage untuk menayangkan iklan video yang dipersonalisasi melalui jaringan pengiriman konten (CDN). MediaPackage adalah layanan pengemasan dan originasi just-in-time video yang mempersiapkan dan melindungi konten video Anda untuk pengiriman melalui internet. Ini mengambil konten video langsung atau sesuai permintaan Anda dan mengemasnya ke dalam format streaming seperti HLS dan DASH, sehingga siap untuk pemirsa di berbagai perangkat.
Saat Anda menggabungkan MediaPackage dengan MediaTailor dan CDN, Anda membuat alur kerja streaming lengkap yang menayangkan iklan yang dipersonalisasi dalam skala besar. CDN mendistribusikan konten Anda secara global, mengurangi latensi dan meningkatkan pengalaman pemirsa, sambil MediaTailor menyisipkan iklan bertarget ke aliran Anda.
Topik ini berfokus pada langkah-langkah integrasi penting untuk mendapatkan MediaTailor MediaPackage, dan CDN Anda bekerja sama. Untuk opsi konfigurasi lanjutan, pemecahan masalah, dan panduan pemantauan, lihat. [Langkah selanjutnya](#emp-cdn-next-steps)
## Memahami alur MediaPackage kerja dan CDN
Sebelum mengonfigurasi integrasi Anda, penting untuk memahami caranya MediaPackage MediaTailor, dan CDN Anda bekerja sama:
1. **Persiapan konten**: MediaPackage menerima konten video langsung atau sesuai permintaan Anda dan mengemasnya ke dalam format streaming (manifes dan segmen HLS atau DASH).
1. **Penyisipan iklan**: MediaTailor meminta manifes dari MediaPackage, menyisipkan iklan yang dipersonalisasi, dan menyajikan manifes yang dimodifikasi kepada pemirsa.
1. **Distribusi global**: CDN Anda menyimpan dan mendistribusikan segmen konten (dari MediaPackage) dan segmen iklan (dari MediaTailor) ke pemirsa di seluruh dunia.
1. **Pemutaran penampil: Pemutar** video meminta manifes melalui CDN, yang merutekan permintaan dengan tepat antara MediaTailor (untuk manifes) dan MediaPackage (untuk segmen konten).
Arsitektur ini memberikan beberapa manfaat:
+ **Skalabilitas**: CDN menangani beban penampil yang tinggi tanpa memengaruhi server asal Anda
+ **Kinerja**: Konten dikirim dari lokasi tepi yang paling dekat dengan pemirsa
+ **Efisiensi biaya**: Mengurangi biaya bandwidth melalui caching
+ **Keandalan**: Beberapa lokasi tepi memberikan redundansi
## Prasyarat
Sebelum Anda mulai, pastikan Anda memiliki komponen berikut yang dikonfigurasi:
1. **MediaPackage endpoint**: MediaPackage Endpoint yang dikonfigurasi yang menerima dan mengemas konten video Anda. Untuk petunjuk penyiapan, lihat [Memulai MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/getting-started.html) di panduan MediaPackage pengguna.
1. **MediaTailor konfigurasi**: MediaTailor Konfigurasi yang menggunakan MediaPackage titik akhir Anda sebagai asal konten. Untuk petunjuk penyiapan, lihat[Mengintegrasikan sumber konten untuk penyisipan MediaTailor iklan](integrating-origin.md).
1. **Distribusi CDN: Distribusi** CDN (seperti CloudFront) dikonfigurasi untuk bekerja dengan media streaming. Untuk petunjuk penyiapan, lihat [Membuat distribusi](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) di panduan CloudFront pengembang.
1. **Server keputusan iklan: Server keputusan** iklan yang dikonfigurasi yang menampilkan respons VAST atau VMAP untuk penyisipan iklan.
## Langkah 1: Konfigurasikan pengaturan CDN penting
Konfigurasi CDN yang tepat sangat penting untuk MediaPackage integrasi yang sukses. Pengaturan yang salah dapat menyebabkan kegagalan pemutaran, kinerja cache yang buruk, dan peningkatan biaya. Tanpa kebijakan cache yang tepat dan penerusan parameter kueri, CDN Anda mungkin tidak mengirimkan manifes dengan benar atau mungkin melewati caching sepenuhnya, yang mengarah ke pemuatan server asal tinggi dan pengalaman penampil yang menurun.
### Konfigurasikan pengaturan cache dasar
Mengkonfigurasi caching dasar sangat penting karena MediaPackage menggunakan header kontrol cache khusus untuk mengoptimalkan pengiriman konten. Tanpa pengaturan cache yang tepat, CDN Anda mungkin mengabaikan header ini, yang mengarah ke permintaan asal yang tidak perlu dan peningkatan latensi. Ikuti langkah-langkah ini untuk memastikan perilaku caching yang optimal:
Untuk mengonfigurasi caching dasar yang berfungsi dengan MediaPackage:
1. Buka pengaturan CloudFront distribusi Anda di CloudFront konsol.
1. Pilih atau buat kebijakan cache untuk MediaPackage asal Anda.
1. Aktifkan opsi “Origin Cache-Control Header”.
1. Izinkan MediaPackage untuk mengontrol perilaku caching melalui header cache-control-nya.
Konfigurasi dasar ini memungkinkan MediaPackage untuk mengatur durasi cache yang sesuai untuk berbagai jenis konten secara otomatis. Untuk menerapkan optimasi cache tingkat lanjut dengan nilai TTL tertentu dan penyetelan kinerja, selesaikan pengaturan dasar ini terlebih dahulu, lalu lanjutkan ke. [Optimalkan caching CDN untuk MediaTailor dan pengiriman konten MediaPackage](cdn-emp-caching.md)
### Konfigurasikan parameter kueri penting
Konfigurasi parameter kueri sangat penting untuk MediaPackage fungsionalitas. CDN Anda harus meneruskan parameter kueri tertentu untuk mengaktifkan fitur seperti tampilan bergeser waktu dan streaming latensi rendah. Pengaturan parameter kueri yang salah dapat mencegah fitur ini berfungsi dan saya khawatir mengurangi efisiensi cache. Ikuti langkah-langkah ini untuk mengonfigurasi penerusan parameter kueri:
Untuk memastikan CDN meneruskan parameter kueri yang diperlukan ke: MediaPackage
1. Di setelan CloudFront distribusi, pilih atau buat kebijakan cache untuk permintaan manifes.
1. Di bawah “Pengaturan kunci cache,” pilih “Sertakan string kueri yang ditentukan.”
1. Tambahkan parameter kueri penting berikut:
+ `start`dan `end` - Untuk fungsionalitas tampilan yang bergeser waktu. Parameter ini diteruskan MediaPackage untuk menentukan jendela konten tertentu untuk tampilan startover dan catch-up
+ `_HLS_msn`dan `_HLS_part` - Untuk mendukung permintaan pemutaran LL-HLS
+ `m`- Untuk menangkap modifikasi ti/compame dari endpoint. MediaPackage respons selalu menyertakan `?m=###` tag untuk menangkap waktu yang dimodifikasi dari titik akhir. Jika konten sudah di-cache dengan nilai berbeda untuk tag ini, CloudFront minta manifes baru alih-alih menyajikan versi cache
+ `aws.manifestfilter`- Untuk fungsionalitas penyaringan manifes. Jika Anda menggunakan pemfilteran manifes, parameter ini harus disertakan untuk mengonfigurasi distribusi guna meneruskan string `aws.manifestfilter` kueri ke MediaPackage asal, yang diperlukan agar fitur pemfilteran manifes berfungsi
1. Hanya sertakan string kueri yang MediaPackage menggunakan. Menyertakan string kueri yang tidak perlu mengurangi efisiensi cache dengan membuat beberapa variasi cache untuk konten yang sama.
Parameter ini memungkinkan MediaPackage fungsionalitas dasar dengan CDN Anda. Jika Anda perlu menerapkan pemfilteran konten untuk berbagai tingkatan langganan atau jenis perangkat, selesaikan pengaturan parameter kueri dasar ini terlebih dahulu, lalu lanjutkan ke. [Siapkan pemfilteran manifes dengan MediaTailor, MediaPackage, dan CDN](cdn-emp-manifest-filtering.md)
Untuk informasi tentang cara MediaTailor meneruskan parameter kueri seperti `start` dan `end` melalui MediaPackage untuk tampilan bergeser waktu, lihat [MediaTailor penanganan parameter kueri untuk asal](origin-query-parameters.md) di. [MediaTailor parameter kueri manifes](manifest-query-parameters.md)
### Konfigurasikan batas waktu respons untuk LL-HLS
Konfigurasi batas waktu sangat penting untuk HLS latensi rendah karena LL-HLS menggunakan mekanisme “permintaan pemblokiran” di mana CDN menunggu segmen konten baru. Jika batas waktu Anda terlalu singkat, permintaan akan gagal sebelumnya MediaPackage dapat merespons dengan segmen baru, menyebabkan gangguan pemutaran dan pengalaman pemirsa yang buruk. Konfigurasikan batas waktu yang sesuai untuk memastikan pemutaran LL-HLS yang lancar:
Jika Anda menggunakan HLS latensi rendah, konfigurasikan pengaturan batas waktu CDN Anda:
1. Di pengaturan CDN Anda, cari konfigurasi batas waktu asal.
1. Tetapkan nilai batas waktu respons setidaknya tiga kali durasi bagian Anda.
1. Misalnya, jika durasi bagian Anda adalah 0,3 detik, atur batas waktu menjadi setidaknya 0,9 detik.
Ini memastikan CDN menunggu cukup lama MediaPackage untuk merespons saat menggunakan mekanisme Permintaan Pemblokiran.
## Langkah 2: Verifikasi integrasi Anda
Menguji integrasi Anda sangat penting untuk memastikan bahwa semua komponen bekerja sama dengan benar sebelum pemirsa Anda mengalami masalah. Integrasi yang gagal dapat mengakibatkan pemutaran rusak, iklan yang hilang, atau kinerja yang buruk. Proses verifikasi ini membantu Anda mengidentifikasi dan menyelesaikan masalah di lingkungan yang terkendali.
Setelah mengonfigurasi setelan CDN Anda, verifikasi bahwa integrasi Anda berfungsi dengan benar dengan menguji alur kerja lengkap dari permintaan konten hingga penyisipan iklan.
### Langkah 2.1: Uji pemutaran dasar
Pengujian pemutaran dasar memverifikasi bahwa CDN Anda menangani permintaan manifes dengan benar dan meneruskannya ke. MediaTailor Tes ini membantu mengidentifikasi masalah konfigurasi dengan kebijakan cache, penerusan parameter kueri, dan penanganan manifes. Ikuti langkah-langkah ini untuk menguji pengiriman manifes dasar:
Uji apakah integrasi dasar Anda berfungsi dengan meminta manifes melalui CDN Anda:
1. Gunakan browser web atau curl untuk meminta URL manifes melalui CDN Anda.
1. Pastikan manifes berhasil dimuat dan berisi segmen konten dan iklan.
1. Periksa segmen konten tersebut URLs di titik manifes ke domain CDN Anda.
1. Konfirmasikan bahwa segmen iklan URLs juga mengarah ke domain CDN Anda.
Jika manifes dimuat dengan benar dan berisi yang diharapkan URLs, integrasi dasar Anda berfungsi. Untuk metodologi pengujian komprehensif dan prosedur validasi lanjutan, lihat. [Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md) Untuk mengatur pemantauan komprehensif kinerja dan kesehatan integrasi Anda, lihat[Memantau kinerja untuk MediaPackage, CDN, dan integrasi MediaTailor](cdn-emp-monitoring.md).
### Langkah 2.2: Uji pemutaran video
Pengujian pemutaran video memastikan bahwa integrasi lengkap Anda berfungsi end-to-end, termasuk penyisipan iklan dan pengiriman konten melalui CDN Anda. Tes ini memverifikasi bahwa segmen konten dan segmen iklan di-cache dan dikirim dengan benar, dan bahwa pengalaman pemirsa memenuhi standar kualitas Anda. Ikuti langkah-langkah ini untuk menguji fungsionalitas pemutaran lengkap:
Uji apakah pemutaran video berfungsi dengan benar dengan iklan yang disisipkan:
1. Gunakan pemutar video (seperti Video.js atau HLS.js) untuk memutar konten Anda melalui CDN.
1. Verifikasi bahwa video diputar dengan lancar tanpa masalah buffering.
1. Konfirmasikan bahwa iklan dimasukkan pada waktu yang diharapkan selama pemutaran.
1. Periksa apakah konten dan segmen iklan dimuat dari CDN Anda (tidak langsung dari asal).
Jika pemutaran berfungsi dengan lancar dengan iklan, integrasi Anda berfungsi dengan benar. Untuk metodologi pengujian komprehensif dan prosedur validasi lanjutan, lihat. [Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md) Jika Anda mengalami masalah pemutaran, buffering, atau penyisipan iklan, lihat. [Memecahkan masalah MediaPackage, CDN, dan integrasi MediaTailor](cdn-emp-troubleshooting.md)
## Langkah selanjutnya
Setelah menyelesaikan integrasi dasar, Anda dapat menerapkan fitur dan pengoptimalan lanjutan:
**Optimasi CDN tingkat lanjut**
Untuk pengoptimalan cache terperinci, konfigurasi TTL, dan penyetelan kinerja, lihat. [Optimalkan caching CDN untuk MediaTailor dan pengiriman konten MediaPackage](cdn-emp-caching.md)
**Penyaringan manifes**
Untuk menerapkan pemfilteran konten untuk layanan berjenjang, pengoptimalan perangkat, atau kontrol akses, lihat. [Siapkan pemfilteran manifes dengan MediaTailor, MediaPackage, dan CDN](cdn-emp-manifest-filtering.md)
**Pemecahan masalah**
Jika Anda mengalami masalah dengan integrasi Anda, lihat[Memecahkan masalah MediaPackage, CDN, dan integrasi MediaTailor](cdn-emp-troubleshooting.md).
**Pemantauan kinerja**
Untuk menyiapkan pemantauan komprehensif dan memahami metrik kinerja utama, lihat[Memantau kinerja untuk MediaPackage, CDN, dan integrasi MediaTailor](cdn-emp-monitoring.md).
# Siapkan pemfilteran manifes dengan MediaTailor, MediaPackage, dan CDN
AWS Elemental MediaTailor menggunakan penyaringan manifes AWS Elemental MediaPackage untuk menyesuaikan aliran audio dan video mana yang disertakan dalam manifes yang dikirimkan ke pemirsa yang berbeda melalui jaringan pengiriman konten (CDN). Ini sangat berguna untuk menerapkan penawaran layanan berjenjang, pengoptimalan khusus perangkat, atau kontrol akses konten.
Topik ini berfokus secara khusus pada penerapan fitur penyaringan manifes. Sebelum menerapkan penyaringan manifes, Anda harus menyelesaikan pengaturan integrasi jaringan pengiriman konten dasar. Jika Anda belum menyiapkan integrasi jaringan pengiriman konten MediaPackage dan dasar, mulailah dengan[Integrasi MediaTailor dengan MediaPackage dan CDN](mediapackage-integration.md).
## Kemampuan penyaringan manifes
Sebelum menerapkan pemfilteran manifes, pahami apa yang dapat Anda capai dengan fitur ini:
### Kemampuan penyaringan inti
Pemfilteran manifes menyediakan beberapa kemampuan utama yang membantu Anda mengontrol pengiriman konten:
+ Batasi akses penampil ke konten premium (seperti 4K HEVC)
+ Targetkan jenis perangkat tertentu dengan aliran yang sesuai
+ Filter konten berdasarkan kecepatan sampel audio, bahasa, atau codec video
+ Memberikan tingkatan kualitas yang berbeda untuk pelanggan yang berbeda
### Kasus penggunaan umum
Kasus penggunaan ini menunjukkan bagaimana penyaringan manifes dapat memenuhi persyaratan bisnis tertentu:
**Tingkatan berlangganan**
Menawarkan pelanggan dasar aliran resolusi yang lebih rendah sambil memberikan pelanggan premium akses ke konten 4K
Contoh: Tingkat dasar terbatas pada 720p, tingkat Premium naik hingga 4K
**Optimalisasi perangkat**
Secara otomatis melayani aliran yang sesuai berdasarkan kemampuan perangkat
Contoh: Perangkat seluler mendapatkan bitrate lebih rendah, pintar TVs mendapatkan kualitas yang lebih tinggi
**Manajemen bandwidth**
Batasi kualitas aliran selama periode penggunaan puncak untuk mengelola biaya jaringan
Contoh: Kurangi bitrate maksimum selama peristiwa lalu lintas tinggi
**Konten regional**
Sajikan berbagai bahasa audio atau varian konten berdasarkan lokasi penampil
Contoh: Secara otomatis memfilter untuk trek audio bahasa lokal
Untuk informasi selengkapnya tentang konsep pemfilteran manifes, lihat [Pemfilteran manifes](https://docs.aws.amazon.com/mediapackage/latest/ug/manifest-filtering.html) di panduan AWS Elemental MediaPackage pengguna.
## Konfigurasikan CDN Anda untuk pemfilteran manifes
Konfigurasi CDN untuk pemfilteran manifes sangat penting karena CDN Anda harus meneruskan parameter `aws.manifestfilter` kueri MediaPackage agar pemfilteran berfungsi. Tanpa penerusan string kueri yang tepat, parameter filter akan dilucuti oleh CDN, dan semua pemirsa akan menerima manifes tanpa filter terlepas dari tingkat langganan atau kemampuan perangkat mereka. Konfigurasi ini memastikan bahwa logika pemfilteran Anda mencapai MediaPackage dan berfungsi sebagaimana dimaksud.
Untuk mengaktifkan pemfilteran manifes melalui CDN Anda, Anda perlu mengonfigurasi penerusan string kueri:
1. Dalam CloudFront distribusi Anda, buat atau edit perilaku cache untuk permintaan manifes.
1. Untuk **kebijakan Cache,** buat kebijakan baru atau edit kebijakan yang sudah ada.
1. Di bawah **Pengaturan kunci cache**, pilih “Sertakan string kueri yang ditentukan.”
1. Tambahkan `aws.manifestfilter` ke daftar string kueri yang diizinkan.
1. Jika Anda juga menggunakan MediaPackage fitur lain, tambahkan parameter kueri mereka:
+ `start`dan `end` - Untuk tampilan yang bergeser waktu
+ `time_delay`- Untuk fungsionalitas waktu tunda
+ `_HLS_msn`dan `_HLS_part` - Untuk LL-HLS
Untuk informasi selengkapnya tentang membuat distribusi, lihat [Membuat distribusi](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) di panduan CloudFront pengembang Amazon.
## Menerapkan penyaringan sisi klien
Implementasi sisi klien adalah tempat Anda menentukan bagaimana pemutar video dan aplikasi Anda meminta konten yang difilter. Konfigurasi ini menentukan konten apa yang diterima setiap pemirsa berdasarkan tingkat langganan, kemampuan perangkat, atau kriteria lainnya. Implementasi yang tepat memastikan bahwa pemirsa hanya menerima konten yang seharusnya mereka akses, sambil mempertahankan efisiensi cache CDN yang optimal.
Untuk menerapkan pemfilteran manifes di pemutar video dan aplikasi Anda:
### Cara kerja penyaringan
Proses penyaringan bekerja sebagai berikut:
1. Pemutar video atau aplikasi Anda meminta URL manifes yang menyertakan parameter filter
1. CDN meneruskan permintaan (termasuk parameter kueri) ke MediaTailor
1. MediaTailor meneruskan parameter filter ke MediaPackage saat meminta manifes asal
1. MediaPackage menerapkan filter dan mengembalikan manifes khusus yang hanya berisi varian yang sesuai dengan kriteria Anda
1. MediaTailor memproses manifes yang difilter untuk penyisipan iklan dan mengembalikannya ke pemutar
### Format URL untuk pemfilteran
Memahami format URL yang benar sangat penting untuk implementasi pemfilteran yang berhasil. Pemformatan URL yang salah akan mengakibatkan parameter penyaringan diabaikan atau menyebabkan kesalahan HTTP. Struktur URL harus menyertakan parameter filter sebagai string kueri yang diteruskan CDN Anda. MediaPackage Ikuti langkah-langkah ini untuk menerapkan pemformatan URL yang tepat:
Untuk menerapkan pemfilteran manifes di pemutar video Anda:
1. Ubah permintaan manifes pemain Anda URLs untuk menyertakan parameter filter yang sesuai.
1. Gunakan format URL berikut dengan parameter kueri:
```
https://CloudFront-Domain/v1/master/MediaTailor-Config/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US
```
1. Ketika pemain Anda meminta URL ini, MediaTailor akan meneruskan parameter ini ke MediaPackage, menghasilkan manifes yang difilter.
## Skenario penyaringan umum
Gunakan contoh ini untuk mengimplementasikan skenario pemfilteran umum:
**Pengiriman konten khusus perangkat**
Untuk memfilter berdasarkan kemampuan perangkat, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100
```
Contoh ini membatasi konten ke video dan audio H.264 dengan kecepatan sampel hingga 44,1 kHz, cocok untuk perangkat seluler.
**Pembatasan konten premium**
Untuk membatasi akses ke konten bitrate tinggi, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=video_bitrate:0-9000000
```
Contoh ini membatasi bitrate video hingga 9 Mbps atau lebih rendah, cocok untuk tingkatan langganan dasar.
**Pemilihan bahasa**
Untuk memfilter bahasa audio tertentu, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=audio_language:fr,en-US,de
```
Contoh ini hanya mencakup trek audio Prancis, Inggris AS, dan Jerman.
**Penargetan resolusi**
Untuk memfilter resolusi video tertentu, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=video_height:240-360,720-1080
```
Contoh ini mencakup aliran video dengan ketinggian antara 240-360 piksel dan 720-1080 piksel, tidak termasuk resolusi mid-range.
**Pemfilteran berbasis codec**
Untuk memfilter codec video tertentu, tambahkan parameter ini ke permintaan manifes Anda:
```
aws.manifestfilter=video_codec:h264,h265
```
Contoh ini hanya mencakup aliran video H.264 dan H.265, tidak termasuk codec lainnya.
## Pertimbangan dan batasan khusus
Untuk menghindari masalah umum saat menerapkan pemfilteran manifes:
### Keterbatasan teknis
+ Untuk manifes TS, gunakan grup rendisi audio untuk menghindari penghapusan aliran video yang dimultipleks dengan aliran audio yang difilter
+ Dalam manifes TS dan CMAF, laju sampel audio dan bitrate video tidak mudah terlihat dalam manifes untuk verifikasi
+ Parameter permintaan yang ditambahkan ke daftar putar atau segmen media akan menghasilkan kesalahan HTTP 400
### Kondisi kesalahan
+ Jika hasil pemfilteran dalam manifes kosong (tidak ada aliran yang memenuhi kriteria filter), MediaPackage akan mengembalikan kesalahan HTTP 400
+ Konfigurasi filter yang bertentangan (filter titik akhir\$1parameter kueri) menghasilkan kesalahan HTTP 404
+ Sintaks filter yang tidak valid atau jenis filter yang tidak didukung menghasilkan kesalahan HTTP 400
### Pertimbangan performa
+ Setiap kombinasi filter unik membuat entri cache terpisah, berpotensi mengurangi efisiensi cache
+ Filter kompleks dengan banyak kriteria dapat memengaruhi kinerja pembuatan manifes
+ Pertimbangkan untuk menggunakan filter tingkat titik akhir untuk skenario penyaringan statis guna meningkatkan kinerja cache
## Uji implementasi penyaringan Anda
Menguji implementasi pemfilteran manifes Anda sangat penting untuk memastikan bahwa pemirsa menerima konten yang benar berdasarkan tingkat akses dan kemampuan perangkat mereka. Pemfilteran yang gagal dapat mengakibatkan pemirsa menerima tingkat kualitas yang salah, format yang tidak didukung, atau konten yang seharusnya tidak dapat mereka akses. Pengujian komprehensif membantu mengidentifikasi dan menyelesaikan masalah ini sebelum memengaruhi pemirsa Anda.
Untuk memverifikasi bahwa pemfilteran manifes Anda berfungsi dengan benar:
1. Minta manifes dengan parameter filter yang berbeda dan verifikasi hasilnya
1. Periksa apakah manifes yang difilter hanya berisi aliran yang diharapkan
1. Uji kasus tepi (hasil kosong, filter tidak valid) untuk memastikan penanganan kesalahan yang tepat
1. Verifikasi bahwa CDN Anda meneruskan parameter filter dengan benar
1. Uji dengan perangkat dan pemain yang berbeda untuk memastikan kompatibilitas
Untuk mengatasi masalah pemfilteran, lihat *Memecahkan MediaPackage * masalah integrasi CDN.
Jika Anda menemukan kesalahan HTTP 400, manifes kosong, atau parameter pemfilteran yang tidak berfungsi seperti yang diharapkan, lihat [Memecahkan masalah MediaPackage, CDN, dan integrasi MediaTailor](cdn-emp-troubleshooting.md) panduan pemecahan masalah pemfilteran manifes tertentu.
# Optimalkan caching CDN untuk MediaTailor dan pengiriman konten MediaPackage
AWS Elemental MediaTailor memerlukan konfigurasi caching jaringan pengiriman konten (CDN) yang tepat untuk kinerja optimal saat digunakan AWS Elemental MediaPackage sebagai asal konten Anda. MediaPackage menyediakan header kontrol cache khusus yang memberi tahu jaringan pengiriman konten Anda berapa lama untuk men-cache berbagai jenis konten. Mengikuti rekomendasi ini memastikan pemutaran yang lancar dan pengiriman konten yang efisien.
Topik ini berfokus secara khusus pada pengoptimalan perilaku caching untuk memaksimalkan kinerja dan meminimalkan biaya. Sebelum menerapkan optimasi caching tingkat lanjut, pastikan Anda telah menyelesaikan pengaturan integrasi jaringan pengiriman konten dasar. Jika Anda belum menyiapkan integrasi dasar Anda, mulailah dengan[Integrasi MediaTailor dengan MediaPackage dan CDN](mediapackage-integration.md).
## MediaPackage header cache-control
MediaPackage menetapkan nilai TTL tertentu untuk jenis konten yang berbeda untuk mengoptimalkan perilaku caching:
**Daftar putar multivarian (HLS dan LL-HLS)**
TTL: Setengah durasi segmen media
Alasan: Daftar putar ini berubah saat segmen baru tersedia, sehingga perlu sering diperbarui
**Daftar putar media (HLS reguler)**
TTL: Setengah durasi segmen media
Alasan: Mirip dengan daftar putar multivarian, pembaruan ini seiring berjalannya konten
**Daftar putar media (LL-HLS)**
TTL: 1 detik
Alasan: Streaming latensi rendah membutuhkan pembaruan yang sangat sering
**Segmen media TS dan segmen init**
TTL: 1209600 detik (14 hari)
Alasan: Segmen media tidak berubah setelah dibuat, sehingga dapat di-cache untuk waktu yang lama
**Segmen media CMAF dan segmen inisialisasi**
TTL: 1209600 detik (14 hari)
Alasan: Seperti segmen TS, ini tidak dapat diubah setelah dibuat
Untuk rekomendasi TTL komprehensif di semua MediaTailor alur kerja dan strategi pengoptimalan caching tambahan, lihat. [Optimasi caching untuk CDN dan integrasi MediaTailor](cdn-optimize-caching.md)
## Konfigurasikan kebijakan cache CDN
Konfigurasi kebijakan cache yang tepat sangat penting untuk kinerja dan efisiensi biaya yang optimal. Berbagai jenis konten (manifes, segmen, file inisialisasi) memiliki persyaratan caching yang berbeda. Menggunakan perilaku cache terpisah memungkinkan Anda mengoptimalkan caching untuk setiap jenis konten, meningkatkan rasio hit cache, dan mengurangi beban asal. Tanpa kebijakan cache yang tepat, Anda mungkin mengalami permintaan asal yang tidak perlu, peningkatan biaya, dan kinerja pemutaran yang buruk.
Untuk menghormati header MediaPackage kontrol cache dengan benar dan mengoptimalkan caching:
1. Buka pengaturan CloudFront distribusi Anda di CloudFront konsol.
1. Buat perilaku cache terpisah untuk jenis konten yang berbeda:
+ Permintaan manifes (\$1.m3u8, \$1.mpd)
+ Segmen media (\$1.ts, \$1.mp4, \$1.m4s)
+ Segmen inisialisasi
1. Untuk setiap perilaku cache, buat atau pilih kebijakan cache dengan pengaturan ini:
+ Aktifkan opsi “Origin Cache-Control Header”
+ Setel “Kebijakan permintaan Asal” untuk meneruskan header yang diperlukan
+ Konfigurasikan penerusan string kueri berdasarkan jenis konten
### Perilaku cache manifes
Untuk permintaan manifes (\$1.m3u8, \$1.mpd):
+ **Pola jalur**: \$1.m3u8 dan\$1.mpd
+ **Kebijakan cache**: Hormati header kontrol cache asal
+ **String kueri**: Teruskan parameter spesifik (lihat[Optimalkan penerusan string kueri](#cdn-query-string-optimization))
+ **Header**: Teruskan semua header (untuk persyaratan minimum, lihat) [Header yang diperlukan untuk integrasi MediaTailor CDN](cdn-configuration.md#cdn-required-headers)
### Perilaku cache segmen media
Untuk segmen media (\$1.ts, \$1.mp4, \$1.m4s):
+ **Pola jalur**: \$1.ts, \$1.mp4, \$1.m4s
+ **Kebijakan cache**: Hormati header kontrol cache asal (TTL 14 hari)
+ **String kueri**: Tidak ada (segmen tidak menggunakan parameter kueri)
+ **Kompresi**: Aktifkan kinerja pengiriman yang lebih baik
## Optimalkan penerusan string kueri
Pengoptimalan string kueri sangat penting untuk efisiensi cache karena parameter kueri yang tidak perlu membuat beberapa variasi cache untuk konten yang sama. Setiap kombinasi parameter kueri unik membuat entri cache terpisah, yang mengurangi rasio hit cache dan meningkatkan permintaan asal. Dengan hanya meneruskan string kueri yang MediaPackage benar-benar digunakan, Anda memaksimalkan efisiensi cache sambil mempertahankan fungsionalitas penuh.
Konfigurasikan CDN Anda untuk meneruskan hanya string kueri yang MediaPackage digunakan, meningkatkan efisiensi cache:
**String kueri penting**
`start`dan `end` - Untuk jendela tampilan yang bergeser waktu
`time_delay`- Untuk menerapkan waktu tunda pada konten manifes
`_HLS_msn`,`_HLS_m`, dan `_HLS_part` - Untuk permintaan pemutaran LL-HLS
**String kueri khusus fitur**
`aws.manifestfilter`- Untuk [penyaringan manifes](cdn-emp-manifest-filtering.md)
**penting**
Jangan sertakan string kueri lainnya di kunci cache Anda. MediaPackage mengabaikan parameter yang tidak dikenal, dan memasukkannya mengurangi efisiensi cache dengan membuat variasi cache yang tidak perlu.
## Teknik optimasi kinerja
Pengoptimalan ini dikonfigurasi pada CDN Anda (seperti CloudFront), bukan di atau. MediaPackage MediaTailor Terapkan pengoptimalan tambahan ini untuk memaksimalkan kinerja cache:
### Perisai asal
Origin shield menyediakan lapisan caching tambahan antara lokasi tepi CDN dan MediaPackage titik akhir Anda. Ini mengurangi jumlah permintaan yang mencapai MediaPackage titik akhir Anda, yang dapat meningkatkan kinerja dan mengurangi biaya, terutama selama lonjakan lalu lintas atau ketika rasio hit cache lebih rendah dari optimal. Origin shield sangat bermanfaat untuk streaming langsung di mana beberapa lokasi tepi mungkin meminta konten yang sama secara bersamaan.
Aktifkan perisai asal untuk mengurangi beban pada MediaPackage titik akhir Anda:
1. Dalam CloudFront distribusi Anda, aktifkan Origin Shield untuk MediaPackage asal Anda.
1. Pilih wilayah perisai asal yang dekat dengan MediaPackage titik akhir Anda.
1. Ini menciptakan lapisan caching tambahan yang mengurangi permintaan ke MediaPackage.
### Konfigurasi kompresi
Aktifkan kompresi untuk respons berbasis teks:
+ Aktifkan kompresi untuk file manifes (\$1.m3u8, \$1.mpd)
+ Jangan kompres segmen media (sudah dikompresi)
+ Pastikan semua header diteruskan ke MediaPackage (untuk persyaratan minimum, lihat) [Header yang diperlukan untuk integrasi MediaTailor CDN](cdn-configuration.md#cdn-required-headers)
## Pantau kinerja cache
Lacak metrik utama ini untuk memastikan kinerja cache yang optimal:
**Rasio hit cache**
Target: 90% atau lebih besar untuk segmen media, 70% atau lebih besar untuk manifes
Rasio rendah mungkin menunjukkan pengaturan TTL yang salah atau parameter kueri yang tidak perlu
**Volume permintaan asal**
Pantau permintaan yang mencapai titik MediaPackage akhir
Volume tinggi mungkin mengindikasikan masalah caching
**Variasi kunci cache**
Tinjau pola kunci cache untuk mengidentifikasi variasi yang tidak perlu
Terlalu banyak variasi mengurangi efisiensi cache
Setelah menerapkan pengoptimalan cache ini, siapkan pemantauan untuk melacak efektivitasnya. Untuk panduan tentang memantau rasio hit cache, pola permintaan asal, dan metrik kinerja utama lainnya, lihat. [Memantau kinerja untuk MediaPackage, CDN, dan integrasi MediaTailor](cdn-emp-monitoring.md) Jika Anda mengamati kinerja cache yang buruk atau permintaan asal yang tidak terduga, lihat [Memecahkan masalah MediaPackage, CDN, dan integrasi MediaTailor](cdn-emp-troubleshooting.md) langkah pemecahan masalah.
# Memantau kinerja untuk MediaPackage, CDN, dan integrasi MediaTailor
AWS Elemental MediaTailor memerlukan pemantauan yang efektif untuk mempertahankan kinerja optimal integrasi jaringan pengiriman konten (CDN) Anda AWS Elemental MediaPackage . Topik ini memberikan panduan tentang metrik utama untuk dilacak, alat pemantauan yang akan digunakan, dan cara mengatur peringatan untuk deteksi masalah proaktif.
Sebelum mengatur pemantauan, pastikan integrasi dasar Anda berfungsi dengan benar. Jika Anda belum menyelesaikan pengaturan integrasi jaringan pengiriman konten dasar, mulailah dengan[Integrasi MediaTailor dengan MediaPackage dan CDN](mediapackage-integration.md). Jika Anda perlu memecahkan masalah yang diidentifikasi melalui pemantauan, lihat.. [Pemecahan masalah integrasi CDN](cdn-emp-troubleshooting.md)
## Metrik kinerja utama
Pantau metrik penting ini untuk memastikan kinerja optimal integrasi Anda MediaPackage dan CDN:
### Metrik kinerja CDN
Untuk metrik kinerja CDN yang komprehensif termasuk target rasio hit cache, pemantauan volume permintaan asal, dan tolok ukur waktu respons, lihat [Tolok ukur kinerja untuk CDN dan integrasi MediaTailor](cdn-performance-benchmarks.md) di panduan pengoptimalan CDN.
Pertimbangan khusus EMP utama untuk metrik CDN:
**Header kontrol cache EMP**
**Apa yang harus diverifikasi**: Pastikan CDN Anda menghormati header kontrol cache EMP untuk perilaku TTL yang optimal
**Perilaku yang diharapkan**: Jenis konten yang berbeda harus memiliki durasi cache yang berbeda berdasarkan header EMP
Untuk panduan terperinci tentang pengoptimalan cache EMP, lihat[Optimalkan caching CDN untuk MediaTailor dan pengiriman konten MediaPackage](cdn-emp-caching.md).
**Dampak parameter kueri**
**Apa yang harus dipantau**: Lacak bagaimana parameter kueri khusus EMP memengaruhi efisiensi cache
**Target pengoptimalan**: Pastikan hanya parameter kueri EMP yang diperlukan yang disertakan dalam kunci cache
**Waktu respons CDN**
**Apa yang harus dipantau**: Lacak waktu respons untuk berbagai jenis konten (manifes vs. segmen).
**Nilai target**:
+ Konten cache: kurang dari 100ms
+ Permintaan asal: kurang dari 500 ms
### MediaPackage metrik kinerja
**Tingkat kesalahan**
**Apa yang harus dipantau**: Pantau tingkat kesalahan HTTP dari CDN dan titik MediaPackage akhir Anda. Berikan perhatian khusus pada kesalahan 4xx, yang mungkin mengindikasikan masalah konfigurasi.
**Kode kesalahan kunci**:
+ 400 kesalahan: Sering terkait dengan masalah pemfilteran manifes
+ 404 kesalahan: Mungkin menunjukkan masalah perutean atau konfigurasi
+ 504 kesalahan: Masalah batas waktu, terutama dengan LL-HLS
**Minta volume dan pola**
**Apa yang harus dipantau**: Lacak pola permintaan ke MediaPackage titik akhir untuk mengidentifikasi tren penggunaan dan kebutuhan kapasitas.
**Pola untuk ditonton**:
+ Waktu penggunaan puncak
+ Distribusi permintaan secara geografis
+ Distribusi jenis konten (langsung vs. sesuai permintaan)
### Metrik latensi
**End-to-end latensi**
**Apa yang harus dipantau**: Untuk implementasi LL-HLS, pantau end-to-end latensi dari konsumsi konten hingga pemutaran pemirsa. Latensi tinggi mungkin mengindikasikan masalah konfigurasi CDN.
**Nilai target**:
+ LL-HLS: latensi kurang dari 3 detik glass-to-glass
+ HLS reguler: kurang dari 30 detik
**Manifestasi waktu generasi**
**Apa yang harus dipantau**: Waktu yang dibutuhkan MediaPackage untuk menghasilkan manifes, terutama dengan penyaringan yang diterapkan.
**Nilai target**: kurang dari 200 md untuk pembuatan manifes
## Alat pemantauan dan penyiapan
Menyiapkan alat pemantauan yang komprehensif sangat penting untuk menjaga kinerja optimal dan mengidentifikasi masalah dengan cepat sebelum berdampak pada pemirsa. Tanpa pemantauan yang tepat, penurunan kinerja, inefisiensi cache, atau masalah integrasi mungkin tidak diperhatikan sampai pemirsa mengalami kualitas pemutaran yang buruk. Pengaturan pemantauan yang tepat memberikan visibilitas ke semua aspek integrasi Anda MediaPackage dan CDN.
Gunakan layanan dan alat AWS ini untuk memantau integrasi Anda MediaPackage dan CDN:
### Amazon CloudWatch
Amazon CloudWatch menyediakan dasar untuk memantau integrasi Anda MediaPackage dan CDN dengan mengumpulkan dan menyimpan metrik dari kedua layanan. CloudWatch Konfigurasi yang tepat memastikan Anda memiliki data yang diperlukan untuk mengidentifikasi tren kinerja, memecahkan masalah, dan mengoptimalkan integrasi Anda. Tanpa CloudWatch metrik, Anda akan kekurangan visibilitas ke kinerja sistem dan mungkin tidak mendeteksi masalah sampai masalah menjadi kritis.
Siapkan CloudWatch pemantauan untuk pengumpulan metrik komprehensif:
1. **MediaPackage metrik**: Aktifkan CloudWatch metrik untuk MediaPackage titik akhir Anda untuk melacak volume permintaan, tingkat kesalahan, dan waktu respons.
1. **Metrik CDN**: Konfigurasikan CloudWatch untuk mengumpulkan CloudFront metrik termasuk rasio hit cache, jumlah permintaan asal, dan tingkat kesalahan.
1. **Metrik khusus**: Buat metrik khusus untuk bisnis khusus KPIs seperti keterlibatan pemirsa atau popularitas konten.
### CloudWatch dasbor
Buat dasbor komprehensif untuk memvisualisasikan metrik Anda:
1. **Dasbor ikhtisar**: Metrik tingkat tinggi yang menunjukkan kesehatan sistem secara keseluruhan
1. **Dasbor kinerja CDN**: Metrik CDN terperinci termasuk kinerja cache dan distribusi geografis
1. **MediaPackage dasbor kinerja**: metrik MediaPackage spesifik termasuk pola permintaan dan tingkat kesalahan
1. **Dasbor latensi**: metrik End-to-end latensi untuk berbagai jenis dan wilayah konten
### Analisis log
Siapkan analisis log untuk pemecahan masalah terperinci:
1. **Log akses CDN**: Aktifkan dan analisis log akses CDN untuk memahami pola permintaan dan mengidentifikasi masalah
1. **MediaPackage CloudWatch log**: Pantau MediaPackage log untuk kesalahan dan masalah kinerja
1. **Agregasi log**: Gunakan Amazon CloudWatch Logs Insights atau alat pihak ketiga untuk menganalisis pola log
## Siapkan peringatan dan notifikasi
Konfigurasi peringatan sangat penting untuk deteksi dan resolusi masalah proaktif. Tanpa peringatan yang tepat, masalah mungkin luput dari perhatian sampai berdampak signifikan pada pengalaman pemirsa atau menyebabkan gangguan layanan. Peringatan yang dikonfigurasi dengan baik membantu Anda mengidentifikasi dan mengatasi masalah sebelum memengaruhi pemirsa Anda, dan memastikan tim Anda diberi tahu tentang masalah kritis yang memerlukan perhatian segera.
Konfigurasikan peringatan proaktif untuk mengidentifikasi masalah sebelum berdampak pada pemirsa:
### Peringatan kritis
Siapkan peringatan langsung untuk masalah kritis:
+ **Tingkat kesalahan tinggi**: Waspada ketika tingkat kesalahan 4xx atau 5xx melebihi 5% selama periode 5 menit
+ **Rasio hit cache turun**: Peringatan saat rasio hit cache turun di bawah 70% untuk manifes atau 85% untuk segmen
+ **Latensi tinggi**: Waspada saat end-to-end latensi melebihi ambang batas target
+ **Lonjakan permintaan asal**: Peringatan saat permintaan asal meningkat lebih dari 50% dibandingkan dengan baseline
### Peringatan peringatan
Siapkan peringatan peringatan untuk tren yang mungkin mengindikasikan masalah yang berkembang:
+ **Degradasi kinerja bertahap**: Waspada saat waktu respons meningkat 20% selama periode 30 menit
+ **Tren efisiensi cache**: Peringatan saat rasio hit cache menunjukkan tren menurun dari waktu ke waktu
+ **Pola lalu lintas yang tidak biasa**: Peringatan untuk perubahan tak terduga dalam volume permintaan atau distribusi geografis
## Gunakan data pemantauan untuk pengoptimalan
Memanfaatkan data pemantauan untuk terus meningkatkan kinerja:
### Ulasan kinerja reguler
1. **Ulasan mingguan**: Analisis tren kinerja mingguan dan identifikasi peluang pengoptimalan
1. **Perencanaan kapasitas bulanan**: Gunakan pola lalu lintas untuk merencanakan kebutuhan kapasitas dan optimasi CDN
1. **Ulasan arsitektur triwulanan**: Mengevaluasi efisiensi arsitektur secara keseluruhan dan mengidentifikasi area untuk perbaikan
### Tindakan optimasi umum
Berdasarkan data pemantauan, pertimbangkan tindakan pengoptimalan ini:
+ **Penyesuaian kebijakan cache**: Ubah nilai TTL berdasarkan pola pembaruan konten aktual. Untuk panduan pengoptimalan TTL terperinci, lihat[Optimasi caching untuk CDN dan integrasi MediaTailor](cdn-optimize-caching.md).
+ **Optimalisasi geografis**: Tambahkan lokasi tepi CDN di wilayah dengan lalu lintas tinggi
+ **Optimalisasi parameter kueri**: Hapus parameter kueri yang tidak perlu yang memecah cache
+ **Konfigurasi perisai asal**: Menerapkan perisai asal di wilayah dengan volume permintaan asal yang tinggi
Untuk panduan pemantauan terperinci khusus untuk MediaPackage, lihat [Pemantauan MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/monitoring.html) dalam panduan MediaPackage pengguna.
# Memecahkan masalah MediaPackage, CDN, dan integrasi MediaTailor
AWS Elemental MediaTailor integrasi dengan AWS Elemental MediaPackage dan jaringan pengiriman konten (CDN) dapat mengalami masalah umum yang memengaruhi pemutaran, caching, atau fungsi integrasi lainnya. Gunakan panduan ini saat Anda mengalami masalah pemutaran, masalah caching, atau kesalahan terkait integrasi lainnya.
Untuk panduan pemecahan masalah CDN yang komprehensif termasuk masalah kinerja cache universal, resolusi kesalahan HTTP, prosedur pengujian, dan teknik diagnostik yang berlaku untuk semua MediaTailor implementasi, lihat. [Memecahkan masalah integrasi CDN](cdn-troubleshooting.md) Bagian ini berfokus pada persyaratan pemecahan masalah MediaPackage tertentu.
Sebelum pemecahan masalah, pastikan Anda telah menyelesaikan pengaturan integrasi dasar dengan benar. Jika Anda belum menyiapkan integrasi atau perlu meninjau langkah-langkah penyiapan, lihat[Integrasi MediaTailor dengan MediaPackage dan CDN](mediapackage-integration.md). Untuk panduan tentang mengoptimalkan kinerja cache setelah menyelesaikan masalah, lihat. [Caching CDN](cdn-emp-caching.md)
## Kesalahan penyaringan manifes
Masalah dengan fungsionalitas penyaringan MediaPackage manifes, berdasarkan kondisi kesalahan yang terdokumentasi:
**Kesalahan HTTP 400 dengan penyaringan manifes**
**Gejala**: Permintaan dengan `aws.manifestfilter` parameter mengembalikan HTTP 400 Permintaan Buruk
**Penyebab yang divalidasi (dari AWS dokumentasi)**:
+ Kriteria filter menghasilkan manifes kosong (tidak ada aliran yang cocok dengan kondisi filter)
+ Nama atau nilai parameter filter tidak valid
+ Sintaks string kueri cacat
+ Parameter filter duplikat atau berulang
+ String parameter filter melebihi 1024 karakter
+ Parameter kueri diterapkan ke daftar putar atau segmen media (tidak didukung)
**Solusi**:
1. Tinjau parameter filter Anda untuk memastikan parameter tersebut cocok dengan aliran konten yang tersedia. Jika pemfilteran tidak menghasilkan aliran yang cocok, MediaPackage mengembalikan HTTP 400.
1. Validasi sintaks filter terhadap nama parameter dan format nilai yang didukung.
1. Periksa parameter duplikat dalam string kueri Anda.
1. Pastikan parameter filter hanya diterapkan pada daftar putar multivarian, bukan ke daftar putar atau segmen media.
1. Verifikasi bahwa string parameter total Anda di bawah 1024 karakter.
**Referensi**: [AWS Elemental MediaPackage kondisi kesalahan penyaringan manifes](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
**Pemfilteran manifes tidak berfungsi (HTTP 200 tetapi tidak ada pemfilteran yang diterapkan)**
**Gejala**: Permintaan mengembalikan HTTP 200 tetapi manifes berisi semua aliran alih-alih subset yang difilter
**Kemungkinan penyebabnya**:
+ CDN tidak meneruskan parameter kueri ke `aws.manifestfilter` MediaPackage
+ Parameter filter tidak ditemukan di aliran yang tersedia (mengembalikan manifes tanpa filter dengan HTTP 200)
**Solusi**:
1. Verifikasi bahwa kebijakan cache CDN Anda termasuk `aws.manifestfilter` dalam daftar string kueri yang diteruskan.
1. Uji parameter filter secara langsung terhadap MediaPackage titik akhir (melewati CDN) untuk memverifikasi bahwa parameter tersebut berfungsi seperti yang diharapkan.
1. Periksa apakah nilai filter cocok dengan karakteristik aktual aliran konten Anda.
**Referensi**: [AWS Elemental MediaPackage kondisi kesalahan penyaringan manifes](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
## Prosedur diagnostik
Prosedur diagnostik sistematis membantu Anda mengidentifikasi akar penyebab masalah integrasi dengan cepat dan efisien. Mengikuti pendekatan terstruktur mencegah waktu yang terbuang pada asumsi yang salah dan memastikan Anda mengatasi masalah yang sebenarnya daripada gejala. Langkah-langkah diagnostik berbasis bukti ini dirancang untuk mengisolasi masalah dan memandu Anda ke solusi yang tepat.
Ikuti langkah-langkah diagnostik berbasis bukti ini untuk mengidentifikasi masalah:
### Menganalisis kinerja cache
Analisis kinerja cache sangat penting untuk integrasi EMP karena efisiensi cache yang buruk menyebabkan peningkatan beban asal, biaya yang lebih tinggi, dan potensi masalah pemutaran.
Untuk pemecahan masalah kinerja cache yang komprehensif termasuk analisis rasio hit cache, pengoptimalan kunci cache, dan langkah-langkah diagnostik sistematis, lihat [Masalah kinerja cache CDN](diagnose-performance-issues.md#cache-performance-troubleshooting) di panduan pemecahan masalah CDN utama.
Pertimbangan cache khusus EMP:
+ **Header kontrol cache EMP: Verifikasi bahwa CDN Anda menghormati header kontrol** cache EMP daripada menggantinya
+ **Parameter kueri EMP: Pastikan hanya parameter** kueri EMP yang diperlukan disertakan dalam kunci cache
+ **Perilaku EMP TTL**: Konfirmasikan jenis konten EMP yang berbeda memiliki durasi cache yang sesuai
Untuk panduan rinci tentang mengoptimalkan kebijakan cache EMP dan pengaturan TTL, lihat. [Optimalkan caching CDN untuk MediaTailor dan pengiriman konten MediaPackage](cdn-emp-caching.md)
### Validasi konfigurasi penyaringan manifes
Validasi penyaringan manifes sangat penting karena masalah pemfilteran dapat mengakibatkan pemirsa menerima konten yang salah, format yang tidak didukung, atau konten yang seharusnya tidak dapat mereka akses. Pengujian sistematis membantu mengidentifikasi apakah masalah terkait dengan konfigurasi CDN, sintaks parameter filter, atau ketersediaan konten.
Uji fungsionalitas penyaringan manifes secara sistematis:
1. Uji parameter filter secara langsung terhadap MediaPackage titik akhir (melewati CDN) untuk memverifikasi bahwa parameter tersebut berfungsi dengan benar.
1. Bandingkan manifes yang difilter dan tidak difilter untuk mengonfirmasi aliran yang diharapkan disertakan/dikecualikan.
1. Verifikasi bahwa kebijakan cache CDN Anda meneruskan `aws.manifestfilter` parameter kueri.
1. Periksa kesalahan HTTP 400 dan cocokkan dengan kondisi kesalahan yang didokumentasikan.
Jika Anda perlu menerapkan atau memodifikasi pemfilteran manifes setelah menyelesaikan masalah, lihat [Siapkan pemfilteran manifes dengan MediaTailor, MediaPackage, dan CDN](cdn-emp-manifest-filtering.md) panduan penyiapan lengkap.
### Validasi konfigurasi parameter kueri
Pastikan CDN Anda hanya meneruskan parameter kueri yang diperlukan:
1. Tinjau kebijakan cache CDN Anda untuk mengonfirmasi bahwa kebijakan tersebut hanya mencakup parameter yang AWS disarankan:
+ `aws.manifestfilter`- untuk penyaringan manifes
+ `aws.manifestsettings`- untuk tampilan bergeser waktu
+ `_HLS_msn`dan `_HLS_part` - untuk dukungan LL-HLS
1. Hapus parameter kueri lain dari kunci cache Anda, karena MediaPackage mengabaikannya dan mengurangi efisiensi cache.
**Referensi**: [Bekerja dengan AWS Elemental MediaPackage dan CDNs](https://docs.aws.amazon.com/mediapackage/latest/userguide/cdns.html)
## Referensi kode kesalahan
Referensi untuk kondisi kesalahan yang terdokumentasi dan penyebabnya:
**HTTP 400 Permintaan Buruk (Penyaringan Manifes)**
**Penyebab yang terdokumentasi**:
+ Penerapan hasil filter dalam manifes kosong
+ Nama atau nilai parameter tidak valid
+ Sintaks string kueri cacat
+ Parameter filter duplikat
+ String parameter melebihi 1024 karakter
+ Parameter kueri pada daftar putar atau segmen media
**Referensi**: [MediaPackage kondisi kesalahan penyaringan manifes](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
**HTTP 200 OK (Tidak Ada Penyaringan Diterapkan)**
**Penyebab yang terdokumentasi**:
+ Parameter filter tidak ditemukan di aliran yang tersedia (mengembalikan manifes tanpa filter)
+ Hanya aliran subtitle yang ada setelah pemfilteran (mengembalikan manifes tanpa filter)
**Referensi**: [MediaPackage kondisi kesalahan penyaringan manifes](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
## Sumber daya pemecahan masalah tambahan
Untuk masalah yang tidak tercakup dalam topik ini, lihat AWS sumber daya resmi ini:
+ [Mempratinjau manifes dari AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/userguide/endpoints-preview.html) - Gunakan pratinjau manifes untuk memecahkan masalah kemasan konten
+ [Tingkatkan rasio hit CloudFront cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html) - Panduan komprehensif untuk pengoptimalan cache CDN
+ [Pemfilteran manifes](https://docs.aws.amazon.com/mediapackage/latest/userguide/manifest-filtering.html) - Panduan lengkap untuk fungsionalitas MediaPackage penyaringan