

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
<a name="cdn-troubleshooting"></a>

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:**
+ Untuk penyiapan operasional dan persiapan pemecahan masalah, lihat [Memecahkan masalah integrasi CDN](#cdn-troubleshooting)
+ Untuk analisis log dan referensi kode kesalahan, lihat [Referensi analisis log integrasi CDN](cdn-log-error-reference.md)
+ Untuk eskalasi dan mendapatkan bantuan tambahan, lihat [Dapatkan dukungan integrasi CDN](cdn-get-help.md)

# Daftar periksa diagnostik untuk MediaTailor dan integrasi CDN
<a name="quick-diagnostic-checklist"></a>

AWS Elemental MediaTailor Masalah integrasi jaringan pengiriman konten (CDN) dapat bermanifestasi dalam berbagai cara. Gunakan daftar periksa ini untuk mengidentifikasi dengan cepat jenis masalah yang Anda alami:

1. **Apakah masalah ini memengaruhi semua pemirsa atau pemirsa tertentu?**
   + Semua pemirsa → Kemungkinan masalah CDN atau MediaTailor konfigurasi
   + Pemirsa spesifik → Kemungkinan masalah personalisasi atau penargetan

1. **Apakah manifes memuat dengan benar?**
   + Tidak → Perutean CDN atau masalah konektivitas MediaTailor 
   + Ya, tetapi konten yang salah → Masalah cache atau personalisasi

1. **Apakah segmen memuat dengan benar?**
   + Segmen konten gagal → Masalah konektivitas asal
   + Segmen iklan gagal → Masalah pengiriman iklan atau transcoding

1. **Apakah iklan dimasukkan dengan benar?**
   + Tidak ada iklan yang muncul → Periksa konektivitas dan konfigurasi ADS
   + Iklan yang salah muncul → Periksa parameter penargetan iklan dan personalisasi
   + Iklan gagal diputar → Periksa transcoding iklan dan ketersediaan segmen

1. **Apakah pemutaran lancar dan tidak terganggu?**
   + Masalah buffering → Periksa kinerja cache CDN dan waktu respons asal
   + Kesalahan pemutaran → Periksa sintaks manifes dan ketersediaan segmen
   + Masalah transisi iklan → Periksa waktu istirahat iklan dan penyelarasan segmen

1. **Apakah ada kode kesalahan atau pesan tertentu?**
   + Kesalahan HTTP 4xx → Periksa perutean dan konfigurasi CDN
   + Kesalahan HTTP 5xx → Periksa server asal dan kesehatan MediaTailor layanan
   + Kesalahan khusus pemain → Periksa format manifes dan kompatibilitas pemain

**Langkah selanjutnya berdasarkan diagnosis Anda:**

Masalah konfigurasi CDN  
Untuk perutean CDN terperinci dan pemecahan masalah caching, lihat. [Memecahkan masalah dengan MediaTailor dan integrasi CDN](cdn-troubleshooting.md)

Masalah manifes dan pemutaran  
Untuk validasi manifes dan pemecahan masalah pemutaran, lihat. [Prosedur pengujian integrasi CDN](cdn-testing-procedures.md)

Masalah penyisipan iklan dan penargetan  
Untuk pemecahan masalah khusus iklan termasuk konektivitas ADS dan penayangan iklan, lihat dokumentasi pemecahan masalah khusus alur kerja Anda.

Masalah kinerja dan pemantauan  
Untuk analisis kinerja dan pengaturan pemantauan, lihat[Pantau operasi dan kinerja MediaTailor CDN](cdn-monitoring.md).

Analisis log dan kode kesalahan  
Untuk analisis log rinci dan referensi kode kesalahan, lihat[Analisis log integrasi CDN dan referensi kode kesalahan untuk MediaTailor](cdn-log-error-reference.md).

Pengujian dan validasi  
Untuk prosedur pengujian yang komprehensif, lihat[Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md).

Jika Anda memerlukan bantuan segera atau tidak dapat menyelesaikan masalah menggunakan sumber daya yang ditautkan, lihat [Dapatkan dukungan dan bantuan pemecahan masalah untuk CDN dan integrasi MediaTailor](cdn-get-help.md) untuk prosedur eskalasi.

# Prosedur pengujian integrasi CDN
<a name="cdn-testing-procedures"></a>

Pengujian yang tepat sangat penting sebelum menerapkan integrasi MediaTailor CDN Anda ke produksi. Prosedur pengujian ini membantu mengidentifikasi masalah konfigurasi, masalah kinerja, dan masalah kompatibilitas di berbagai perangkat dan platform.

## Validasi integrasi dasar
<a name="basic-integration-testing"></a>

Lakukan tes mendasar ini untuk memverifikasi integrasi CDN Anda berfungsi dengan benar:

1. **Uji pengiriman manifes**:
   + Minta manifes melalui CDN Anda dan verifikasi bahwa ia mengembalikan respons yang valid
   + Verifikasi manifes berisi konten yang diharapkan dan titik penyisipan iklan
   + Periksa apakah manifes URLs menggunakan domain CDN Anda, bukan asal
   + Validasi sintaks manifes menggunakan alat validasi HLS atau DASH

1. **Verifikasi penulisan ulang URL**:
   + Periksa bahwa segmen konten URLs dalam manifes mengarah ke domain CDN Anda
   + Verifikasi URLs titik segmen iklan ke domain CDN Anda
   + Pastikan semua kerabat URLs diselesaikan dengan benar

1. **Uji pemutaran konten**:
   + Putar konten melalui pemutar video dan verifikasi pemutaran yang lancar
   + Verifikasi konten dan iklan diputar tanpa gangguan
   + Periksa transisi yang tepat antara konten dan iklan
   + Uji fungsi pencarian dan penggosokan

1. **Validasi perutean CDN**:
   + Pantau log akses CDN untuk memastikan permintaan dirutekan dengan benar
   + Verifikasi hit/miss pola cache seperti yang diharapkan
   + Periksa apakah permintaan asal hanya terjadi untuk kesalahan cache

## Prosedur pengujian lanjutan
<a name="advanced-integration-testing"></a>

Lakukan tes tambahan ini untuk validasi komprehensif:

1. **Pengujian kompatibilitas lintas platform**:
   + Uji pada beberapa perangkat (desktop, ponsel, tablet, smart TV)
   + Verifikasi kompatibilitas di berbagai browser
   + Uji dengan berbagai pemutar video (HLS.js, Video.js, pemutar asli)
   + Validasi pada sistem operasi yang berbeda

1. **Pengujian kinerja**:
   + Ukur waktu respons permintaan manifes (target: <100ms untuk cache)
   + Uji kinerja pemuatan segmen di berbagai bitrate
   + Verifikasi waktu startup memenuhi target kinerja
   + Uji dalam berbagai kondisi jaringan

1. **Validasi pelacakan iklan**:
   + Verifikasi penembakan suar pelacakan iklan dengan benar
   + Periksa data analitik iklan untuk akurasi
   + Uji tayangan dan pelacakan penyelesaian
   + Validasi fungsionalitas klik-tayang

1. **Pengujian kondisi kesalahan**:
   + Uji perilaku saat asal tidak tersedia untuk sementara
   + Verifikasi penanganan permintaan cacat yang anggun
   + Uji skenario failover CDN
   + Validasi kejelasan dan kegunaan pesan kesalahan

## Buat lingkungan pengujian
<a name="test-environment-setup"></a>

Siapkan lingkungan pengujian yang mencerminkan konfigurasi produksi Anda untuk validasi komprehensif:

1. Siapkan distribusi CDN terpisah untuk pengujian:
   + Buat distribusi CDN uji dengan perilaku cache yang sama dengan produksi
   + Konfigurasikan asal pengujian yang mencerminkan pengaturan produksi Anda
   + Gunakan nama domain terpisah untuk menghindari konflik dengan lalu lintas produksi

1. Buat MediaTailor konfigurasi pengujian:
   + Siapkan konfigurasi pemutaran uji dengan pengaturan yang sama dengan produksi
   + Konfigurasikan titik akhir server keputusan iklan pengujian
   + Menggunakan konten iklan uji yang cocok dengan format iklan produksi

1. Menerapkan proses pengujian sistematis:
   + Buat daftar periksa pengujian untuk perubahan konfigurasi
   + Prosedur pengujian dokumen untuk tim Anda
   + Siapkan pengujian otomatis jika memungkinkan

## Uji di beberapa skenario
<a name="multi-scenario-testing"></a>

Validasi integrasi Anda di berbagai skenario dan kondisi untuk memastikan cakupan yang komprehensif:

1. Uji dengan beberapa jenis dan perangkat pemain:
   + Uji dengan pemutar video yang berbeda (web, seluler, TV yang terhubung)
   + Validasi di berbagai sistem operasi dan browser
   + Uji pada berbagai kondisi jaringan dan kecepatan koneksi

1. Buat skrip pengujian otomatis:
   + Otomatiskan validasi permintaan manifes
   + Buat skrip untuk menguji skenario penyisipan iklan
   + Menerapkan pengujian kinerja untuk skenario lalu lintas tinggi

1. Validasi penargetan dan personalisasi iklan:
   + Uji dengan profil pengguna yang berbeda dan parameter penargetan
   + Validasi integrasi server keputusan iklan
   + Uji skenario fallback saat iklan tidak tersedia

## Alat dan teknik pengujian
<a name="testing-tools-techniques"></a>

Gunakan alat dan teknik ini untuk pengujian yang efektif:

Alat pengembang browser  
Gunakan tab Jaringan untuk memeriksa permintaan dan tanggapan HTTP  
Monitor konsol untuk JavaScript kesalahan dan peringatan  
Verifikasi header respons dan perilaku caching  
Periksa informasi waktu untuk analisis kinerja

Pengujian baris perintah  
Gunakan curl untuk menguji spesifik URLs dan memeriksa header:  

```
curl -I "https://your-cdn-domain.com/path/to/manifest.m3u8"
```
Gunakan wget untuk pengujian unduhan dan analisis waktu  
Gunakan alat seperti httpie untuk pengujian HTTP yang lebih mudah dibaca

Pengujian pemutar video  
Uji dengan beberapa implementasi pemain  
Gunakan mode debug pemain untuk memeriksa perilaku internal  
Pantau peristiwa pemain dan panggilan balik kesalahan  
Validasi perilaku pengalihan bitrate adaptif

Analisis dan pemantauan CDN  
Pantau metrik CDN waktu nyata selama pengujian  
Tinjau log akses untuk pola permintaan  
Gunakan alat pengujian khusus CDN-bila tersedia  
Siapkan peringatan sementara untuk menguji validasi

Untuk metodologi pengujian komprehensif tambahan dan pendekatan validasi sistematis, lihat. [Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md)

# Memecahkan masalah kesalahan manifes CDN 404 untuk MediaTailor
<a name="common-integration-issues"></a>

AWS Elemental MediaTailor kesalahan manifes 404 jaringan pengiriman konten (CDN) adalah masalah integrasi umum yang mencegah pemutaran dimulai. Bagian ini menyediakan step-by-step pemecahan masalah untuk kegagalan pengiriman manifes. 

Daftar putar multivariant, daftar putar media, atau permintaan MPD mengembalikan 404 kesalahan  
**Perbaikan cepat (coba dulu):**  

1. Verifikasi nama MediaTailor konfigurasi di URL Anda sama persis (peka huruf besar/kecil)

1. Uji URL manifes secara langsung terhadap MediaTailor tanpa CDN: `curl -v "https://your-emt-endpoint.mediatailor.region.amazonaws.com/v1/master/hls/config-name/master.m3u8"`

1. Jika pengujian langsung berhasil, periksa aturan perutean CDN untuk permintaan manifes
**Jika perbaikan cepat tidak berhasil:**  
**Gejala:** Pemain gagal memulai pemutaran, permintaan manifes mengembalikan kesalahan HTTP 404 di log CDN.  
**Contoh pesan kesalahan:**  
+ Konsol browser: `"Failed to load resource: the server responded with a status of 404 (Not Found)"`
+ Kesalahan pemain: `"MANIFEST_LOAD_ERROR"` atau `"NETWORK_ERROR"`
+ Log CDN: `GET /v1/master/hls/example-config/master.m3u8 404`
**Resolusi:**  
Verifikasi bahwa aturan perutean CDN Anda dikonfigurasi dengan benar untuk meneruskan daftar putar multivarian, daftar putar media, dan permintaan MPD ke. MediaTailor  
Periksa apakah MediaTailor konfigurasi ada dan diatur dengan benar.  
Pastikan pola perilaku CDN Anda cocok dengan jalur permintaan manifes yang diharapkan (misalnya,`*.m3u8`,`*.mpd`).

# Mendiagnosis masalah pengiriman manifes CDN dan kesalahan untuk MediaTailor
<a name="diagnose-manifest-issues"></a>

AWS Elemental MediaTailor Masalah pengiriman manifes jaringan pengiriman konten (CDN) dapat mencegah penyisipan dan pemutaran iklan yang tepat. Jika pemirsa menerima iklan yang salah atau tidak konsisten dalam daftar putar multivarian, daftar putar media, atau: MPDs

1. Periksa manifes yang di-cache:
   + Verifikasi pengaturan TTL diatur ke 0 untuk semua daftar putar multivarian, daftar putar media, dan jalur MPD
   + Konfirmasikan bahwa CDN Anda tidak menyimpan daftar putar multivarian, daftar putar media, atau terlepas dari pengaturan TTL MPDs 
   + Periksa log CDN untuk status cache - permintaan manifes harus ditampilkan `Miss` atau`RefreshHit`, tidak `Hit`

1. Verifikasi konfigurasi perutean CDN:
   + Konfirmasi permintaan manifes sedang dirutekan ke MediaTailor titik akhir, bukan di-cache atau disajikan dari asal
   + Periksa apakah pola perilaku CDN cocok dengan jalur manifes dengan benar (\$1.m3u8, \$1.mpd)
   + Verifikasi parameter kueri sedang diteruskan ke untuk personalisasi MediaTailor 
   + Uji manifes URLs langsung terhadap MediaTailor untuk mengisolasi masalah CDN vs layanan

1. Periksa konfigurasi penerusan header:
   + Verifikasi header yang diperlukan sedang diteruskan (lihat) [Header yang diperlukan untuk integrasi MediaTailor CDN](cdn-configuration.md#cdn-required-headers)
   + Konfirmasi header User-Agent diteruskan untuk penargetan iklan khusus perangkat
   + Periksa apakah X-Forwarded-For header diteruskan untuk penargetan geografis
   + Pastikan header Accept-Encoding diteruskan untuk dukungan kompresi

1. Validasi konten dan struktur manifes:
   + Periksa apakah manifes berisi penanda penyisipan iklan yang diharapkan (EXT-X-CUE-OUT/IN untuk HLS)
   + Verifikasi segmen URLs dalam manifes menggunakan domain CDN Anda, bukan domain asal
   + Konfirmasikan segmen iklan disisipkan dan dapat diakses dengan benar
   + Uji sintaks manifes menggunakan alat validasi (ffprobe untuk HLS, mp4box untuk DASH)

1. Uji skenario yang berbeda:
   + Tes dengan sesi yang berbeda IDs untuk memverifikasi personalisasi berfungsi
   + Uji dari lokasi geografis yang berbeda untuk memverifikasi penargetan geografis
   + Uji dengan string User-Agent yang berbeda untuk memverifikasi penargetan perangkat
   + Bandingkan respons nyata dengan dan tanpa CDN untuk mengidentifikasi perbedaan

**Sumber daya pemecahan masalah tambahan:**
+ Untuk konfigurasi caching CDN yang mendetail, lihat [Optimasi caching untuk CDN dan integrasi MediaTailor](cdn-optimize-caching.md)
+ Untuk pengaturan perutean CDN yang komprehensif, lihat [Siapkan perilaku perutean CDN untuk MediaTailor](cdn-routing-behaviors.md)
+ Untuk persyaratan penerusan header, lihat [Header yang diperlukan untuk integrasi MediaTailor CDN](cdn-configuration.md#cdn-required-headers)
+ Untuk analisis log dan kode kesalahan, lihat [Analisis log integrasi CDN dan referensi kode kesalahan untuk MediaTailor](cdn-log-error-reference.md)
+ Untuk prosedur pengujian dan validasi, lihat [Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md)

**Kriteria keberhasilan:** Ketika diselesaikan, pemain harus memulai pemutaran secara normal dan iklan akan muncul seperti yang diharapkan. Permintaan manifes harus menampilkan kode status HTTP 200 di log CDN, dan manifes harus berisi konten iklan yang dipersonalisasi dengan benar.

# Memecahkan masalah pengiriman dan pemuatan segmen CDN untuk MediaTailor
<a name="diagnose-segment-issues"></a>

AWS Elemental MediaTailor Masalah pengiriman segmen jaringan pengiriman konten (CDN) dapat menyebabkan gangguan buffering dan pemutaran. Jika pemain tidak dapat memuat segmen atau mengalami buffering:

1. Periksa aturan perutean CDN:
   + Verifikasi segmen konten sedang dirutekan ke asal yang benar
   + Konfirmasi segmen iklan sedang dirutekan ke lokasi penyimpanan MediaTailor iklan yang benar
   + Periksa apakah ekstensi file SEGMEN cocok dengan pola perilaku CDN Anda
   + Verifikasi bahwa segmen URLs dalam manifes menggunakan domain CDN yang benar
   + Untuk petunjuk mendetail tentang pengaturan pola jalur perutean dan perilaku, lihat [Siapkan perilaku perutean CDN untuk MediaTailor](cdn-routing-behaviors.md)

1. Verifikasi konfigurasi CORS:
   + Untuk pemutar web, pastikan CDN Anda melewati atau mengatur header CORS dengan benar
   + Uji dengan alat pengembang browser untuk mengidentifikasi kesalahan terkait CORS
   + Verifikasi bahwa permintaan OPSI preflight ditangani dengan benar

1. Uji aksesibilitas dan kinerja segmen:
   + Uji segmen individual URLs secara langsung untuk memverifikasi bahwa mereka dapat diakses
   + Periksa waktu respons segmen dan identifikasi kemacetan kinerja
   + Verifikasi ukuran file segmen sesuai untuk target bandwidth Anda
   + Uji pemuatan segmen dari lokasi geografis yang berbeda

1. Validasi perilaku caching CDN untuk segmen:
   + Verifikasi segmen konten memiliki pengaturan TTL yang sesuai (biasanya lebih panjang dari manifes)
   + Periksa apakah segmen iklan di-cache dengan tepat berdasarkan persyaratan personalisasi
   + Pantau rasio hit cache untuk segmen konten dan iklan
   + Pastikan kunci cache tidak menyertakan parameter yang tidak perlu yang mengurangi efisiensi cache

1. Periksa konektivitas dan kesehatan server asal:
   + Verifikasi server asal merespons permintaan segmen dengan benar
   + Periksa kapasitas server asal dan waktu respons di bawah beban
   + Validasi bahwa server asal memiliki file segmen yang diharapkan tersedia
   + Uji skenario failover asal jika beberapa asal dikonfigurasi

1. Memecahkan masalah spesifik segmen iklan:
   + Verifikasi segmen iklan ditranskode dengan benar dan tersedia di MediaTailor
   + Periksa apakah segmen iklan URLs dibuat dengan benar dalam manifes
   + Uji pemuatan segmen iklan dengan parameter penargetan iklan yang berbeda
   + Memantau penundaan transcoding iklan yang dapat menyebabkan tidak tersedianya segmen

1. Validasi kompatibilitas dan perilaku pemain:
   + Uji pemuatan segmen dengan berbagai jenis dan versi pemain
   + Periksa pengaturan buffer pemain dan pola permintaan segmen
   + Verifikasi penanganan kesalahan pemain untuk permintaan segmen yang gagal
   + Uji pengalihan bitrate adaptif dan logika pemilihan segmen

**Sumber daya pemecahan masalah tambahan:**
+ Untuk konfigurasi perutean dan perilaku CDN, lihat [Siapkan perilaku perutean CDN untuk MediaTailor](cdn-routing-behaviors.md)
+ Untuk optimasi caching CDN, lihat [Optimasi caching untuk CDN dan integrasi MediaTailor](cdn-optimize-caching.md)
+ Untuk panduan konfigurasi CORS, lihat [Praktik terbaik keamanan integrasi CDN untuk MediaTailor](cdn-security-best-practices.md)
+ Untuk pemantauan dan analisis kinerja, lihat [Pantau operasi dan kinerja MediaTailor CDN](cdn-monitoring.md)
+ Untuk prosedur pengujian yang komprehensif, lihat [Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md)
+ Untuk analisis log dan diagnosis kesalahan, lihat [Analisis log integrasi CDN dan referensi kode kesalahan untuk MediaTailor](cdn-log-error-reference.md)

**Kriteria keberhasilan:** Ketika diselesaikan, pemain harus memuat segmen dengan lancar tanpa gangguan buffering. Permintaan segmen harus menampilkan kode status HTTP 200 dengan waktu respons yang sesuai, dan segmen konten dan iklan harus dapat diakses dan di-cache dengan benar.

# Perbaiki masalah manajemen sesi CDN dan pelacakan MediaTailor
<a name="diagnose-session-issues"></a>

AWS Elemental MediaTailor Manajemen sesi jaringan pengiriman konten (CDN) sangat penting untuk personalisasi dan pelacakan iklan yang tepat. Jika Anda menemukan kesalahan terkait sesi atau perilaku yang tidak konsisten di seluruh permintaan:

1. Periksa konsistensi ID sesi:
   + Verifikasi bahwa pemain Anda mempertahankan ID sesi yang sama di semua permintaan untuk satu sesi pemutaran
   + Periksa log CDN untuk mengonfirmasi sesi IDs diteruskan dengan benar
   + Pastikan sesi IDs dikodekan URL dengan benar dalam parameter kueri
   + Gunakan CloudWatch Log untuk memverifikasi konsistensi ID sesi di seluruh permintaan (lihat langkah validasi di bawah)

1. Validasi inisialisasi sesi:
   + Konfirmasikan bahwa permintaan manifes pertama berhasil membuat sesi
   + Periksa penerusan parameter sesi yang tepat (misalnya,) `aws.sessionId`
   + Verifikasi inisialisasi sesi menggunakan log debug (lihat pengaturan log debug di bawah)

1. Aktifkan pencatatan debug untuk pemecahan masalah sesi terperinci:
   + **Untuk pelaporan sisi server:** Tambahkan `?aws.logMode=DEBUG` ke permintaan pemutaran Anda:

     ```
     GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUG
     ```
   + **Untuk pelaporan sisi klien:** Sertakan `"logMode": "DEBUG"` dalam badan permintaan inisialisasi sesi Anda
   + **Penting:** `DEBUG` Nilai peka huruf besar/kecil
   + Maksimal 10 sesi debug aktif diizinkan secara bersamaan

1. Gunakan kueri CloudWatch Log untuk memvalidasi perilaku sesi:
   + **Verifikasi sesi debug aktif:**

     ```
     fields @timestamp, @message
     | filter sessionId = "your-session-id-here"
     | filter eventType = "SESSION_INITIALIZED" # client-side reporting
     or mediaTailorPath like "/v1/master" # server-side reporting HLS
     or mediaTailorPath like "/v1/dash" # server-side reporting DASH
     ```
   + **Lihat semua acara untuk satu sesi:**

     ```
     fields @timestamp, @message, eventType, mediaTailorPath
     | filter sessionId = "your-session-id-here"
     | sort @timestamp asc
     ```
   + **Periksa pembuatan manifes untuk sesi:**

     ```
     fields @timestamp, responseBody, @message
     | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "your-session-id-here"
     ```

1. Penerusan parameter sesi uji melalui CDN:
   + Uji permintaan manifes dengan parameter sesi langsung terhadap MediaTailor (melewati CDN)
   + Bandingkan perilaku sesi dengan dan tanpa CDN untuk mengidentifikasi masalah penerusan
   + Verifikasi konfigurasi penerusan parameter kueri CDN mencakup parameter terkait sesi
   + Periksa apakah CDN tidak menyimpan respons yang harus spesifik untuk sesi

**Pesan kesalahan sesi umum:**
+ `ConflictException`(HTTP 409) - Beberapa permintaan daftar putar simultan untuk sesi yang sama. **Solusi:** Pastikan pemain Anda meminta daftar putar satu per satu sesuai dengan spesifikasi HLS
+ `NotFoundException`(HTTP 404) - Sesi tidak tersedia atau konfigurasi tidak ada. **Solusi:** Periksa validitas konfigurasi Anda dan inisialisasi ulang sesi
+ `BadRequestException`(HTTP 400) - ID sesi tidak valid atau permintaan yang tidak diformat dengan benar. **Solusi:** Verifikasi pemformatan permintaan dan validitas ID sesi

**Sumber daya pemecahan masalah tambahan:**
+ Untuk penyiapan pencatatan debug lengkap dan referensi bidang, lihat [Menghasilkan AWS Elemental MediaTailor log debug](debug-log-mode.md)
+ Untuk CloudWatch contoh kueri Log dan analisis log, lihat [Menulis AWS Elemental MediaTailor log langsung ke Amazon CloudWatch Logs](monitoring-cw-logs.md)
+ Untuk konfigurasi penerusan parameter kueri CDN, lihat [Siapkan perilaku perutean CDN untuk MediaTailor](cdn-routing-behaviors.md)
+ Untuk referensi kode kesalahan yang komprehensif, lihat [Memecahkan masalah pemutaran dari MediaTailor](playback-errors.md)

**Kriteria keberhasilan:** Ketika diselesaikan, sesi harus diinisialisasi dengan benar, mempertahankan sesi yang konsisten IDs di seluruh permintaan, dan log debug harus menampilkan `SESSION_INITIALIZED` peristiwa yang tepat dan pembuatan manifes tanpa kesalahan.

# Mengatasi masalah waktu istirahat iklan CDN dan sinkronisasi MediaTailor
<a name="diagnose-timing-issues"></a>

AWS Elemental MediaTailor Waktu istirahat iklan jaringan pengiriman konten (CDN) harus disinkronkan secara tepat dengan penanda konten. Jika iklan muncul pada waktu yang salah atau waktu jeda iklan tidak konsisten:

1. Verifikasi penanda jeda iklan di konten:
   + Periksa apakah penanda SCTE-35 ditempatkan dengan benar di konten asal Anda
   + Verifikasi durasi jeda iklan cocok dengan panjang konten iklan yang sebenarnya
   + Konfirmasikan bahwa waktu jeda iklan selaras dengan batas konten
   + Validasi format penanda SCTE-35 dan akurasi waktu dalam manifes asal Anda
   + Uji penanda jeda iklan dengan jenis konten yang berbeda (langsung vs VOD)

1. Periksa dampak caching CDN pada waktu:
   + Pastikan manifes TTL diatur ke 0 untuk mencegah penyimpangan waktu
   + Verifikasi bahwa parameter sensitif waktu tidak di-cache
   + Periksa masalah sinkronisasi jam antara sumber konten MediaTailor, dan CDN
   + Pantau penyimpangan waktu dalam streaming langsung yang berjalan lama
   + Verifikasi sinkronisasi waktu server tepi CDN dengan NTP

1. Validasi implementasi penanda SCTE-35:
   + Verifikasi EXT-X-DATERANGE tag menyertakan spesifikasi SCTE35 -OUT dan DURATION yang tepat
   + Periksa penanda SCTE35 -OUT dan -IN yang dipasangkan saat menggunakan waktu isyarat SCTE35 masuk eksplisit
   + Validasi stempel waktu START-DATE sejajar dengan waktu konten aktual
   + Uji format penanda SCTE-35 yang berbeda (penanda berbasis durasi vs berpasangan)

1. Uji waktu istirahat iklan di berbagai skenario:
   + Bandingkan waktu jeda iklan dengan MediaTailor permintaan langsung vs permintaan CDN
   + Uji konsistensi waktu di berbagai lokasi tepi CDN
   + Verifikasi waktu istirahat iklan dengan berbagai jenis pemain dan perilaku buffering
   + Pantau akurasi waktu selama periode lalu lintas puncak

1. Masalah waktu debug menggunakan log dan pemantauan:
   + Aktifkan pencatatan debug untuk melacak waktu pemrosesan jeda iklan
   + Pantau CloudWatch metrik untuk pola waktu penyisipan iklan
   + Periksa log CDN untuk pola permintaan terkait waktu
   + Gunakan alat debugging pemain untuk memverifikasi waktu istirahat iklan dari perspektif klien

**Toleransi waktu yang diharapkan:**
+ Waktu istirahat iklan harus selaras dengan penanda SCTE-35 di konten Anda
+ Durasi iklan harus sesuai dengan durasi yang ditentukan dalam respons server keputusan iklan Anda
+ Sinkronisasi jam antara sumber konten, MediaTailor, dan CDN harus dalam 1 detik
+ Waktu penanda SCTE-35 harus akurat hingga 100 ms dari waktu konten aktual

**Sumber daya pemecahan masalah tambahan:**
+ Untuk format dan implementasi penanda SCTE-35, lihat [Mengintegrasikan sumber konten untuk penyisipan MediaTailor iklan](integrating-origin.md)
+ Untuk penyiapan pencatatan debug dan analisis waktu, lihat [Menghasilkan AWS Elemental MediaTailor log debug](debug-log-mode.md)
+ Untuk konfigurasi caching CDN dan dampak waktu, lihat [Optimasi caching untuk CDN dan integrasi MediaTailor](cdn-optimize-caching.md)
+ Untuk prosedur pengujian komprehensif termasuk validasi waktu, lihat [Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md)
+ Untuk memantau waktu dan performa penyisipan iklan, lihat [Pantau operasi dan kinerja MediaTailor CDN](cdn-monitoring.md)

**Kriteria keberhasilan:** Ketika diselesaikan, jeda iklan akan muncul tepat pada waktu yang ditentukan oleh penanda SCTE-35, dengan waktu yang konsisten di semua lokasi tepi CDN dan jenis pemain. Log debug harus menampilkan waktu pemrosesan jeda iklan yang akurat tanpa kesalahan penyimpangan atau sinkronisasi.

# Optimalkan kinerja CDN dan selesaikan masalah latensi MediaTailor
<a name="diagnose-performance-issues"></a>

AWS Elemental MediaTailor Kinerja integrasi jaringan pengiriman konten (CDN) secara langsung memengaruhi pengalaman pemirsa dan kualitas penayangan iklan. Jika Anda mengalami waktu respons yang lambat atau penurunan kinerja:

## Teknik pengukuran kinerja
<a name="performance-measurement-techniques"></a>

Sebelum memecahkan masalah kinerja, buat pengukuran dasar dan pemantauan berkelanjutan:

1. Ukur metrik kinerja utama:
   + **Waktu respons:** Permintaan manifes harus selesai dalam 200ms, permintaan segmen dalam 100 ms
   + **Rasio hit cache:** Segmen konten > 95%, segmen iklan> 90%
   + **Volume permintaan asal:** Harus kurang dari 5% dari total permintaan saat cache dioptimalkan
   + **Waktu ke frame pertama:** Pemutaran awal harus dimulai dalam 2-3 detik

1. Gunakan alat pengukuran kinerja:
   + **Dasbor analitik CDN:** Pantau kinerja cache, waktu respons, dan tingkat kesalahan
   + **CloudWatch metrik:** Melacak metrik MediaTailor layanan termasuk .Latency GetManifest
   + **Alat pengembang browser:** Ukur kinerja sisi klien dan waktu jaringan
   + **Alat baris perintah:** Gunakan curl dengan opsi waktu untuk mengukur permintaan tertentu

1. Menerapkan pemantauan berkelanjutan:
   + Siapkan peringatan kinerja otomatis untuk degradasi waktu respons
   + Pantau kinerja di berbagai wilayah geografis
   + Lacak kinerja selama periode lalu lintas puncak
   + Bandingkan metrik kinerja sebelum dan sesudah perubahan konfigurasi

**Sumber daya pengukuran kinerja:**
+ Untuk pengaturan pemantauan kinerja yang komprehensif, lihat [Pantau operasi dan kinerja MediaTailor CDN](cdn-monitoring.md)
+ Untuk prosedur pengujian kinerja, lihat [Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md)
+ Untuk CloudWatch metrik dan pemantauan, lihat [Pemantauan AWS Elemental MediaTailor dengan CloudWatch metrik Amazon](monitoring-cloudwatch-metrics.md)

## Masalah kinerja cache CDN
<a name="cache-performance-troubleshooting"></a>

Masalah kinerja cache adalah salah satu masalah integrasi CDN yang paling umum. Masalah-masalah ini memengaruhi semua MediaTailor implementasi dan dapat secara signifikan memengaruhi pengalaman dan biaya pemirsa.

**Rasio hit cache rendah**  
**Gejala**: Volume permintaan asal tinggi, peningkatan latensi, biaya bandwidth yang lebih tinggi, pengalaman pemirsa yang buruk  
**Nilai target**:  
+ Segmen konten: 95% atau rasio hit cache lebih tinggi
+ Segmen iklan: 90% atau rasio hit cache lebih tinggi
+ Manifes: Bervariasi berdasarkan implementasi (manifes yang dipersonalisasi tidak boleh di-cache)
**Penyebab umum**:  
+ Pengaturan TTL salah untuk jenis konten yang berbeda
+ Konfigurasi kunci cache mencakup parameter kueri yang tidak perlu
+ Header kontrol cache dari asal tidak dikonfigurasi dengan benar
+ Pembatalan atau pembersihan cache yang sering
+ Masalah distribusi geografis (konten tidak di-cache di lokasi tepi)
**Solusi**:  

1. Tinjau dan optimalkan pengaturan TTL:
   + Segmen konten: Setel TTL agar sesuai dengan durasi segmen atau lebih lama
   + Segmen iklan: Setel TTL ke 24 jam atau lebih lama untuk iklan yang dapat digunakan kembali
   + Aset statis: Setel TTL ke 24 jam atau lebih

   Untuk rekomendasi TTL yang komprehensif dan strategi optimasi caching, lihat. [Optimasi caching untuk CDN dan integrasi MediaTailor](cdn-optimize-caching.md)

1. Optimalkan konfigurasi kunci cache:
   + Hapus parameter kueri yang tidak perlu dari kunci cache
   + Pastikan hanya parameter yang memengaruhi konten yang disertakan
   + Menormalkan urutan parameter dan sensitivitas kasus

1. Verifikasi header kontrol cache asal diatur dengan benar

1. Menerapkan perisai asal (atau fungsionalitas CDN yang setara) untuk implementasi lalu lintas tinggi. Fungsionalitas perisai asal tersedia di seluruh mayor CDNs tetapi mungkin memiliki nama yang berbeda (seperti CloudFront Origin Shield, Fastly Shield, Cloudflare Argo Tiered Cache). Jika CDN Anda tidak menawarkan fungsionalitas ini, CDN dapat diaktifkan MediaTailor saat Anda menghubungi [AWS Support](https://aws.amazon.com/premiumsupport/).

1. Tinjau strategi pembatalan cache dan kurangi pembersihan yang tidak perlu
**Langkah-langkah validasi**:  

1. Pantau rasio hit cache menggunakan dasbor analitik CDN

1. Uji spesifik URLs dengan curl untuk memverifikasi header cache

1. Bandingkan volume permintaan asal sebelum dan sesudah perubahan

**Volume permintaan asal tinggi**  
**Gejala**: Tiba-tiba tingginya jumlah permintaan yang mencapai MediaTailor asal, peningkatan beban server asal, biaya lebih tinggi  
**Pola yang diharapkan**: Permintaan asal harus kurang dari 5% dari total permintaan pemirsa saat rasio hit cache optimal  
**Penyebab umum**:  
+ Cache meleset karena nilai TTL rendah
+ Fragmentasi kunci cache (terlalu banyak kunci cache unik)
+ Lalu lintas geografis melonjak di wilayah tanpa konten cache
+ Pembatalan cache yang sering
**Solusi**:  

1. Menganalisis pola permintaan untuk mengidentifikasi penyebab kehilangan cache

1. Optimalkan pengaturan TTL berdasarkan jenis konten dan frekuensi pembaruan

1. Menerapkan strategi pemanasan cache untuk konten baru

1. Pertimbangkan implementasi perisai asal (tersedia di seluruh mayor CDNs dengan nama berbeda - lihat [Implementasi Origin Shield](cdn-advanced-optimization.md#origin-shield-optimization) detailnya)
**Ambang batas peringatan**: Tetapkan peringatan saat permintaan asal melebihi 10% dari total permintaan atau meningkat 50% dari baseline

## Resolusi kesalahan HTTP umum
<a name="http-error-troubleshooting"></a>

Kesalahan HTTP dalam integrasi CDN sering menunjukkan masalah konfigurasi atau masalah layanan. Pola kesalahan ini konsisten di semua MediaTailor implementasi.

**404 Kesalahan Tidak Ditemukan**  
**Gejala**: Permintaan manifes atau segmen mengembalikan HTTP 404, pemain gagal memuat konten, “MANIFEST\$1LOAD\$1ERROR” di log pemain  
**Penyebab umum**:  
+ Konfigurasi asal CDN salah (URL MediaTailor titik akhir yang salah)
+ Pola jalur perilaku cache yang hilang atau salah
+ Masalah penulisan ulang URL dalam konfigurasi CDN
+ MediaTailor nama konfigurasi atau kesalahan titik akhir pemutaran
+ Masalah pengaturan waktu dengan konten langsung (meminta segmen masa depan)
**Langkah-langkah diagnostik**:  

1. Uji URL yang sama secara langsung terhadap MediaTailor asal (bypass CDN)

1. Verifikasi konfigurasi asal CDN cocok dengan titik akhir MediaTailor pemutaran

1. Periksa pola dan prioritas jalur perilaku cache CDN

1. Tinjau log akses CDN untuk detail perutean permintaan

1. Validasi nama MediaTailor konfigurasi dan pengaturan wilayah
**Solusi**:  
+ Konfigurasi asal CDN yang benar agar sesuai dengan titik akhir MediaTailor pemutaran
+ Perbarui pola jalur perilaku cache untuk merutekan permintaan dengan benar
+ Perbaiki aturan penulisan ulang URL jika berlaku
+ Verifikasi MediaTailor konfigurasi ada dan aktif

**403 Kesalahan terlarang**  
**Gejala**: Permintaan mengembalikan HTTP 403, akses pesan ditolak, kegagalan otentikasi  
**Penyebab umum**:  
+ Parameter kueri yang hilang atau salah yang diperlukan oleh MediaTailor
+ CDN tidak meneruskan header atau parameter yang diperlukan
+ Pembatasan alamat IP atau pemblokiran geografis
+ Masalah token otentikasi (jika menggunakan ditandatangani URLs)
**Solusi**:  
+ Verifikasi semua parameter kueri yang diperlukan disertakan dan diteruskan
+ Periksa konfigurasi CDN untuk penerusan header dan parameter
+ Tinjau pembatasan IP dan pengaturan geografis
+ Validasi token otentikasi dan proses penandatanganan

**400 kesalahan Permintaan Buruk**  
**Gejala**: Permintaan mengembalikan HTTP 400, kesalahan permintaan cacat, kegagalan validasi parameter  
**Penyebab umum**:  
+ Parameter kueri yang salah bentuk atau masalah pengkodean URL
+ Nilai atau format parameter tidak valid
+ Parameter yang diperlukan tidak ada untuk MediaTailor fitur tertentu
+ Keterbatasan panjang URL terlampaui
**Solusi**:  
+ Validasi format parameter kueri dan pengkodean URL
+ Periksa nilai parameter terhadap persyaratan MediaTailor API
+ Pastikan semua parameter yang diperlukan disertakan
+ Tinjau panjang URL dan pertimbangkan pengoptimalan parameter

**Kesalahan server 5xx**  
**Gejala**: Permintaan mengembalikan kesalahan HTTP 500, 502, 503, atau 504, kegagalan layanan intermiten  
**Penyebab umum**:  
+ MediaTailor masalah layanan atau keterbatasan kapasitas
+ Masalah konektivitas asal CDN
+ Masalah batas waktu karena respons asal yang lambat
+ Degradasi layanan sementara
**Solusi**:  
+ Periksa AWS Service Health Dashboard untuk status MediaTailor layanan
+ Verifikasi konektivitas asal CDN dan pengaturan batas waktu
+ Terapkan logika coba lagi dengan backoff eksponensial
+ Pantau MediaTailor CloudWatch metrik untuk kesehatan layanan
+ Hubungi AWS Support jika masalah terus berlanjut

1. Ukur kinerja dasar:
   + Uji waktu respons permintaan manifes langsung ke MediaTailor (target: <200ms)
   + Ukur waktu respons CDN untuk permintaan manifes (target: <100ms untuk klik cache)
   + Periksa waktu pemuatan segmen dari asal dan CDN

1. Menganalisis kinerja CDN:
   + Periksa rasio hit cache untuk segmen konten (target: > 80% untuk konten populer)
   + Verifikasi perisai asal (atau fungsionalitas CDN yang setara) diaktifkan dan dikonfigurasi di AWS Wilayah yang sama dengan asal Anda. Berbeda CDNs menggunakan nama yang berbeda untuk fungsi ini
   + Pantau kinerja lokasi tepi CDN dan distribusi geografis

**Tolok ukur kinerja:**
+ Pantau waktu respons pembuatan manifes dan bandingkan dengan kinerja dasar Anda
+ Hit cache CDN secara signifikan lebih cepat daripada permintaan asal
+ Waktu respons ADS seharusnya tidak menyebabkan penundaan pembuatan manifes

**Sumber daya pemecahan masalah tambahan:**
+ Untuk strategi optimasi kinerja yang komprehensif, lihat [Panduan optimasi kinerja untuk CDN dan integrasi MediaTailor](cdn-optimization.md)
+ Untuk detail implementasi perisai asal, lihat [Implementasi Origin Shield](cdn-advanced-optimization.md#origin-shield-optimization)
+ Untuk optimasi caching CDN, lihat [Optimasi caching untuk CDN dan integrasi MediaTailor](cdn-optimize-caching.md)
+ Untuk pemantauan kinerja dan metrik, lihat [Pantau operasi dan kinerja MediaTailor CDN](cdn-monitoring.md)
+ Untuk prosedur pengujian kinerja, lihat [Pengujian dan validasi untuk CDN dan integrasi MediaTailor](cdn-integration-testing.md)

**Kriteria keberhasilan:** Ketika diselesaikan, waktu respons harus memenuhi tolok ukur target (manifes kurang dari 200 md, segmen kurang dari 100 ms), rasio hit cache harus melebihi 90% untuk sebagian besar jenis konten, dan volume permintaan asal harus kurang dari 5% dari total permintaan. Kinerja harus konsisten di semua wilayah geografis dan jenis perangkat.

# Perbaiki perilaku CDN yang tidak konsisten di seluruh perangkat dan platform untuk MediaTailor
<a name="resolve-inconsistent-behavior"></a>

AWS Elemental MediaTailor Integrasi jaringan pengiriman konten (CDN) harus menyediakan penayangan iklan yang konsisten di semua perangkat dan platform. Jika iklan berperilaku berbeda di seluruh perangkat:

1. Pastikan penerusan header yang konsisten di semua perilaku CDN.
   + Verifikasi bahwa User-Agent X-Forwarded-For, dan header penargetan kustom diteruskan secara konsisten
   + Periksa apakah aturan penerusan header berlaku untuk semua perilaku cache yang relevan

1. Verifikasi kompatibilitas pemain dengan konfigurasi CDN Anda.
   + Uji dengan beberapa jenis pemain (HLS.js, Video.js, pemain asli) untuk mengidentifikasi masalah khusus pemain
   + Periksa persyaratan header khusus pemain atau perbedaan penanganan URL

1. Uji dengan beberapa jenis perangkat untuk mengidentifikasi masalah khusus perangkat.
   + Sertakan perangkat seluler, tablet, browser pintar TVs, dan desktop dalam pengujian Anda
   + Uji berbagai sistem operasi dan versi browser
   + Verifikasi bahwa penargetan iklan khusus perangkat berfungsi dengan benar

Jika Anda telah mengikuti langkah-langkah pemecahan masalah ini dan masih membutuhkan bantuan, lihat. [Dapatkan dukungan integrasi CDN](cdn-get-help.md)

## Persiapan pemecahan masalah
<a name="troubleshooting-preparation"></a>

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
<a name="enable-comprehensive-logging"></a>

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

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

1. 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
<a name="add-diagnostic-headers"></a>

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

1. 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
<a name="establish-baseline-metrics"></a>

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

1. **Harapan kinerja dokumen**:
   + Target rasio hit cache (95% \$1 untuk konten, 90% \$1 untuk iklan)
   + Waktu respons yang dapat diterima (<100ms cache, <500ms asal)
   + Tingkat kesalahan maksimum yang dapat diterima (< 1% untuk 4xx, < 0,1% untuk 5xx)

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

### Siapkan alat pemecahan masalah
<a name="prepare-troubleshooting-tools"></a>

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

1. Alat **baris perintah**:
   + `curl`untuk menguji permintaan dan tanggapan HTTP
   + `dig`atau `nslookup` untuk pemecahan masalah DNS
   + Alat validasi HLS/DASH untuk verifikasi manifes
   + Alat analisis log (grep, awk, atau penganalisis log khusus)

1. **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

1. **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
<a name="workflow-specific-troubleshooting"></a>

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](cdn-emp-troubleshooting.md)  
**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**:
+ Untuk panduan pengoptimalan kinerja, lihat [Optimalisasi kinerja CDN](cdn-optimization.md)
+ Untuk pengaturan pemantauan dan peringatan, lihat [Pemantauan CDN](cdn-monitoring.md)
+ Untuk dukungan dan bantuan umum, lihat [Dapatkan dukungan integrasi CDN](cdn-get-help.md)