Memecahkan masalah dengan MediaTailor dan integrasi CDN - AWS Elemental MediaTailor
Persiapan pemecahan masalahPanduan pemecahan masalah khusus alur kerja

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memecahkan masalah dengan MediaTailor dan integrasi CDN

Panduan pemecahan masalah komprehensif ini mencakup masalah integrasi jaringan pengiriman konten (CDN) umum di semua AWS Elemental MediaTailor implementasi termasuk penyisipan iklan sisi server (SSAI), perakitan saluran, dan integrasi. AWS Elemental MediaPackage Ketika CDN dan MediaTailor integrasi Anda mengalami masalah, gunakan pendekatan diagnostik sistematis ini untuk mengidentifikasi akar penyebab dengan cepat dan menerapkan solusi yang divalidasi.

Panduan ini berlaku untuk semua integrasi MediaTailor CDN terlepas dari alur kerja spesifik Anda. Untuk masalah khusus untuk layanan atau alur kerja tertentu, lihat bagian pemecahan masalah terkait yang direferensikan di akhir panduan ini.

Sebelum Anda mulai: Siapkan item ini untuk pemecahan masalah yang efisien:

  • Contoh pemutaran URLs yang menunjukkan masalah

  • Log akses CDN dari periode waktu ketika masalah terjadi

  • MediaTailor nama konfigurasi dan AWS Wilayah

  • Jenis dan versi pemain (misalnya, HLS.js 1.4.0, Video.js 8.0)

  • Informasi perangkat dan browser di mana masalah terjadi

Topik terkait:

Persiapan pemecahan masalah

Siapkan alat dan proses untuk menyederhanakan pemecahan masalah saat masalah integrasi CDN muncul. Persiapan proaktif membuat pemecahan masalah lebih cepat dan lebih efektif ketika masalah terjadi.

Aktifkan pencatatan komprehensif

Log terperinci sangat penting untuk mendiagnosis masalah integrasi CDN. Konfigurasikan logging untuk menangkap informasi yang Anda perlukan selama pemecahan masalah.

  1. Aktifkan log akses CDN terperinci:

    • Konfigurasikan logging untuk semua perilaku cache yang menangani MediaTailor permintaan

    • Sertakan string kueri dan header khusus dalam entri log

    • Siapkan alat analisis log untuk mengidentifikasi pola dan anomali

    • Aktifkan log waktu nyata untuk deteksi masalah langsung selama acara langsung

    • Konfigurasikan kebijakan penyimpanan log untuk mempertahankan data pemecahan masalah historis

  2. Konfigurasikan MediaTailor logging:

    • Aktifkan log akses untuk MediaTailor konfigurasi Anda

    • Siapkan grup CloudWatch log untuk manajemen log terpusat

    • Konfigurasikan filter log untuk mengidentifikasi pola kesalahan

  3. Siapkan pencatatan server asal:

    • Aktifkan log akses terperinci di server asal konten Anda

    • Sertakan header permintaan dan kode respons di log

    • Pantau metrik kinerja server asal

Tambahkan header permintaan diagnostik

Header khusus membantu melacak permintaan melalui CDN Anda dan mengidentifikasi masalah perutean.

  1. Konfigurasikan header diagnostik CDN:

    • Tambahkan pengenal unik untuk setiap permintaan (misalnya,X-Request-ID)

    • Sertakan informasi khusus CDN di header permintaan

    • Tambahkan lokasi tepi atau informasi POP (titik keberadaan) untuk melacak perutean geografis

    • Sertakan header status cache (Hit, Miss, RefreshHit) untuk analisis perilaku cache

  2. Tambahkan header respons untuk debugging:

    • Sertakan header identifikasi server

    • Tambahkan informasi waktu untuk analisis kinerja

    • Sertakan header kontrol cache untuk permintaan manifes

Menetapkan metrik kinerja dasar

Dokumentasikan rentang kinerja normal untuk mengidentifikasi anomali dengan cepat selama pemecahan masalah:

  1. Rekam metrik dasar:

    • Rasio hit cache untuk berbagai jenis konten

    • Persentil waktu respons (P50, P95, P99)

    • Tingkat kesalahan berdasarkan kode status

    • Minta pola volume berdasarkan waktu

  2. Harapan kinerja dokumen:

    • Target rasio hit cache (95% + untuk konten, 90% + untuk iklan)

    • Waktu respons yang dapat diterima (<100ms cache, <500ms asal)

    • Tingkat kesalahan maksimum yang dapat diterima (< 1% untuk 4xx, < 0,1% untuk 5xx)

  3. Buat dasbor kinerja: Siapkan dasbor pemantauan yang menampilkan metrik saat ini dibandingkan dengan nilai dasar.

Siapkan alat pemecahan masalah

Siapkan alat dan izin akses yang diperlukan untuk pemecahan masalah yang efektif:

  1. Alat baris perintah:

    • curluntuk menguji permintaan dan tanggapan HTTP

    • digatau nslookup untuk pemecahan masalah DNS

    • Alat validasi HLS/DASH untuk verifikasi manifes

    • Alat analisis log (grep, awk, atau penganalisis log khusus)

  2. Izin akses:

    • Akses konsol manajemen CDN untuk tinjauan konfigurasi

    • MediaTailor akses konsol untuk verifikasi konfigurasi

    • CloudWatch akses untuk metrik dan analisis log

    • Akses server asal untuk pemecahan masalah backend

  3. Dokumentasi:

    • Diagram arsitektur jaringan

    • CDN dan dokumentasi MediaTailor konfigurasi

    • Informasi kontak untuk prosedur eskalasi

    • Memecahkan masalah runbook untuk skenario umum

Panduan pemecahan masalah khusus alur kerja

Panduan pemecahan masalah universal ini mencakup masalah umum di semua integrasi MediaTailor CDN. Untuk masalah khusus untuk alur kerja atau layanan tertentu, lihat sumber pemecahan masalah khusus ini:

Pemecahan masalah penyisipan iklan sisi server (SSAI)

Untuk masalah khusus SSAI termasuk kegagalan penyisipan iklan, masalah transisi iklan, dan masalah personalisasi, lihat dokumentasi pemecahan masalah SSAI khusus alur kerja.

Masalah umum khusus SSAI:

  • Kegagalan penyisipan iklan dan jeda iklan kosong

  • Masalah waktu transisi iklan dan sinkronisasi

  • Masalah personalisasi dan penargetan

  • Pelacakan iklan dan perbedaan analitik

Pemecahan masalah perakitan saluran

Untuk masalah khusus perakitan saluran termasuk masalah pembuatan manifes dan fungsionalitas pergeseran waktu, lihat dokumentasi alur kerja perakitan saluran.

Masalah perakitan saluran umum:

  • Kesalahan pembuatan dan kompilasi manifes

  • Jendela pergeseran waktu dan masalah fungsionalitas DVR

  • Ketersediaan konten sumber dan masalah failover

  • Jadwal program dan sinkronisasi metadata

MediaPackage pemecahan masalah integrasi

Untuk masalah MediaPackage spesifik termasuk pemfilteran manifes dan masalah titik akhir EMP, lihat. Pemecahan masalah integrasi CDN

Masalah MediaPackage integrasi umum:

  • Kesalahan parameter penyaringan manifes

  • MediaPackage masalah konektivitas titik akhir

  • Masalah perilaku cache khusus EMP

  • MediaPackage masalah otentikasi asal

CloudFront pemecahan masalah khusus

Untuk masalah konfigurasi dan penyiapan CloudFront tertentu, lihat dokumentasi CloudFront integrasi.

CloudFront Masalah umum:

  • Konfigurasi distribusi dan pengaturan perilaku cache

  • Identitas akses asal dan konfigurasi keamanan

  • CloudFront kode kesalahan tertentu dan tanggapan

  • Pembatasan geografis dan masalah lokasi tepi

Sumber daya tambahan: