View a markdown version of this page

Memantau dan memecahkan masalah Anda CloudFront dan MediaTailor integrasi - AWS Elemental MediaTailor

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

Memantau dan memecahkan masalah Anda CloudFront dan MediaTailor integrasi

AWS Elemental MediaTailor integrasi dengan Amazon CloudFront memerlukan pemantauan dan pemecahan masalah berkelanjutan untuk mempertahankan kinerja yang optimal. Setelah menerapkan MediaTailor integrasi Anda CloudFront , pantau kinerja dan bersiaplah untuk memecahkan masalah apa pun. Jaringan pengiriman konten (CDN) menyediakan alat untuk membantu Anda memahami kinerja distribusi Anda dan mengidentifikasi potensi masalah.

Menyiapkan pemantauan untuk integrasi Anda

Terapkan strategi pemantauan ini untuk melacak kinerja Anda CloudFront dan MediaTailor integrasi:

Untuk mengatur pemantauan untuk Anda CloudFront dan MediaTailor integrasi
  1. Aktif CloudFront kan pencatatan standar:

    1. Di CloudFront konsol, pilih distribusi Anda.

    2. Pilih tab Log.

    3. Di bawah log standar, pilih Edit.

    4. Pilih Aktif dan konfigurasikan bucket Amazon S3 untuk penyimpanan log.

    5. Pilih Simpan perubahan.

  2. Siapkan log CloudFront waktu nyata:

    1. Di CloudFront konsol, pilih distribusi Anda.

    2. Pilih tab Log.

    3. Di bawah Real-time log, pilih Edit.

    4. Pilih Aktif dan konfigurasikan aliran pengiriman Amazon Kinesis Data Streams atau Amazon Data Firehose.

    5. Sertakan bidang ini dalam konfigurasi log Anda:

      • time-to-first-byte- Waktu respon

      • sc-status- Kode status HTTP

      • c-ip- Alamat IP penampil

      • cs-uri-stem- Minta jalur URI

      • cs-user-agent- Agen pengguna

      • x-edge-result-type- Jenis hasil (Hit, Miss, Error)

    6. Pilih Simpan perubahan.

  3. Buat CloudWatch dasbor:

    1. Di CloudWatch konsol, pilih Dasbor.

    2. Pilih Buat dasbor.

    3. Tambahkan widget untuk CloudFront metrik ini:

      • Permintaan

      • BytesDownloaded

      • 4xx ErrorRate

      • 5xx ErrorRate

      • TotalErrorRate

      • CacheHitRate

  4. Siapkan CloudWatch alarm:

    1. Di CloudWatch konsol, pilih Alarm.

    2. Pilih Buat alarm.

    3. Buat alarm untuk kondisi ini:

      • 5xx ErrorRate > 1% selama 5 menit

      • 4xx ErrorRate lebih besar dari 5% selama 5 menit

      • CacheHitRate kurang dari 80% selama 30 menit

Memantau kinerja MQAR

Saat menggunakan MQAR, pemantauan membantu Anda memahami CloudFront bagaimana memilih antara asal Anda dan apakah skor kualitas memenuhi harapan. Real-time log menunjukkan keputusan ini saat terjadi.

Untuk memantau kinerja MQAR
  1. Aktifkan log real-time untuk CloudFront distribusi Anda.

  2. Sertakan bidang ini dalam konfigurasi log Anda:

    • r-host- Nama host dari asal yang dipilih

    • sr-reason- Alasan pemilihan asal

    • x-edge-mqcs- Skor kepercayaan kualitas media

  3. Siapkan tujuan log di Amazon Kinesis Data Streams atau Amazon Data Firehose.

  4. Buat dasbor atau peringatan berdasarkan metrik ini untuk memantau skor kualitas dan keputusan pemilihan asal.

contoh Das CloudWatch bor sampel untuk pemantauan MQAR

Buat CloudWatch dasbor dengan metrik berikut:

  • Pemilihan asal dihitung berdasarkan Wilayah

  • Skor kualitas rata-rata dari waktu ke waktu

  • Peristiwa failover

  • Tingkat kesalahan 4xx dan 5xx berdasarkan asal

Untuk informasi selengkapnya tentang menyiapkan log real-time, lihat Real-time log di panduan CloudFront pengembang.

Memecahkan masalah umum

Masalah dapat muncul dengan Anda CloudFront dan MediaTailor integrasi bahkan dengan perencanaan yang cermat. Memahami masalah dan solusi umum membantu Anda menyelesaikan masalah dengan cepat dan meminimalkan dampak pemirsa.

Jika Anda mengalami masalah dengan MediaTailor integrasi CloudFront dan Anda, periksa masalah umum dan solusi berikut:

Masalah cache manifes

Gejala: Man ifes basi atau iklan tidak diperbarui

Solusi: Pastikan Anda menggunakan kebijakan CachingDisabled cache untuk daftar putar multivarian, daftar putar media, dan jalur MPD. Periksa apakah konfigurasi Anda meneruskan parameter kueri dengan benar.

Kesalahan CORS

Gejala: Konsol browser menunjukkan kesalahan CORS saat mengakses konten

Solusi: Konfigurasikan kebijakan header respons dengan header CORS yang sesuai dan kaitkan dengan perilaku cache Anda.

MQAR tidak berfungsi

Gejala: Pemilihan asal mengabaikan skor kualitas

Solusi: Periksa apakah Anda telah mengaktifkan opsi Skor kualitas media di setelan grup asal Anda. Pastikan Anda tidak menggunakan pemicu yang menghadap ke asal Lambda @Edge.

Kegagalan penyisipan iklan

Gejala: I klan tidak dimasukkan dengan benar

Solusi: Verifikasi MediaTailor konfigurasi Anda mengarah ke CloudFront distribusi untuk awalan segmen konten. Periksa apakah pengaturan Anda meneruskan semua header yang diperlukan.

Untuk masalah yang lebih kompleks, Anda dapat menggunakan pendekatan pemecahan masalah ini:

  1. Per CloudFront iksa log distribusi untuk pola kesalahan

  2. Gunakan alat pengembang browser untuk memeriksa permintaan jaringan

  3. Bandingkan konten manifes dari MediaTailor langsung dibandingkan dengan konten yang dikirimkan melalui CloudFront

  4. Uji dengan pemutar sederhana yang mendukung pencatatan terperinci

Untuk bantuan pemecahan masalah lainnya, lihat https://docs.aws.amazon.com/mediatailor/latest/ug/troubleshooting.html bagian Pemecahan Masalah di panduan MediaTailor pengguna.

Alur kerja pemecahan masalah

Ikuti pendekatan sistematis ini untuk memecahkan masalah dengan MediaTailor integrasi Anda CloudFront :

Untuk memecahkan masalah CloudFront dan MediaTailor integrasi
  1. Identifikasi masalah spesifik:

    1. Tentukan apakah masalah mempengaruhi semua pemirsa atau hanya sebagian

    2. Mengidentifikasi jenis konten yang terpengaruh (manifes, segmen, atau keduanya)

    3. Perhatikan pesan kesalahan atau gejala

  2. Periksa CloudFront log:

    1. Cari kode status kesalahan (4xx atau 5xx)

    2. Periksa hit/miss pola cache

    3. Verifikasi bahwa permintaan diarahkan ke asal yang benar

  3. Verifikasi konfigurasi:

    1. Periksa perilaku cache untuk pola jalur yang benar

    2. Verifikasi kebijakan cache diterapkan dengan benar

    3. Konfirmasikan bahwa kebijakan permintaan asal meneruskan header yang diperlukan

  4. Uji akses langsung:

    1. Coba akses konten langsung dari MediaTailor (bypass) CloudFront

    2. Bandingkan tanggapan antara akses langsung dan CloudFront akses

  5. Menerapkan solusi:

    1. Terapkan perbaikan yang sesuai berdasarkan temuan Anda

    2. Uji untuk memverifikasi masalah telah teratasi

    3. Dokumentasikan masalah dan solusi untuk referensi di masa mendatang

Langkah selanjutnya

Setelah menyiapkan pemantauan dan pemecahan masalah untuk MediaTailor integrasi Anda CloudFront , pertimbangkan langkah-langkah berikut ini: