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 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, lihatIntegrasi MediaTailor dengan MediaPackage dan CDN . Untuk panduan tentang mengoptimalkan kinerja cache setelah menyelesaikan masalah, lihat. Caching CDN

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.

2. Validasi sintaks filter terhadap nama parameter dan format nilai yang didukung.

3. Periksa parameter duplikat dalam string kueri Anda.

4. Pastikan parameter filter hanya diterapkan pada daftar putar multivarian, bukan ke daftar putar atau segmen media.

5. Verifikasi bahwa string parameter total Anda di bawah 1024 karakter.

Referensi: AWS Elemental MediaPackage kondisi kesalahan penyaringan manifes

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.

2. Uji parameter filter secara langsung terhadap MediaPackage titik akhir (melewati CDN) untuk memverifikasi bahwa parameter tersebut berfungsi seperti yang diharapkan.

3. Periksa apakah nilai filter cocok dengan karakteristik aktual aliran konten Anda.

Referensi: AWS Elemental MediaPackage kondisi kesalahan penyaringan manifes

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

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.

2. Bandingkan manifes yang difilter dan tidak difilter untuk mengonfirmasi aliran yang diharapkan disertakan/dikecualikan.

3. Verifikasi bahwa kebijakan cache CDN Anda meneruskan aws.manifestfilter parameter kueri.

4. 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 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_msndan _HLS_part - untuk dukungan LL-HLS

2. Hapus parameter kueri lain dari kunci cache Anda, karena MediaPackage mengabaikannya dan mengurangi efisiensi cache.

Referensi: Bekerja dengan AWS Elemental MediaPackage dan CDNs

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

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

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 - Gunakan pratinjau manifes untuk memecahkan masalah kemasan konten

• Tingkatkan rasio hit CloudFront cache - Panduan komprehensif untuk pengoptimalan cache CDN

• Pemfilteran manifes - Panduan lengkap untuk fungsionalitas MediaPackage penyaringan