本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 針對 MediaTailor 和 CDN 整合的問題進行故障診斷
<a name="cdn-troubleshooting"></a>

此全方位疑難排解指南涵蓋所有 AWS Elemental MediaTailor 實作的常見內容交付網路 (CDN) 整合問題，包括伺服器端廣告插入 (SSAI)、頻道組合和 AWS Elemental MediaPackage 整合。當您的 CDN 和 MediaTailor 整合遇到問題時，請使用此系統化診斷方法來快速識別根本原因並實作經過驗證的解決方案。

本指南適用於所有 MediaTailor CDN 整合，無論您的特定工作流程為何。如需特定服務或工作流程的特定問題，請參閱本指南結尾所參考的相關故障診斷章節。

**開始之前：**準備好這些項目以進行有效的故障診斷：
+ 示範問題的播放 URLs範例
+ 發生問題期間的 CDN 存取日誌
+ MediaTailor 組態名稱和 AWS 區域
+ 玩家類型和版本 （例如 HLS.js 1.4.0、Video.js 8.0)
+ 發生問題的裝置和瀏覽器資訊

**相關主題：**
+ 如需操作設定和疑難排解準備，請參閱 [故障診斷 CDN 整合](#cdn-troubleshooting)
+ 如需日誌分析和錯誤碼參考，請參閱 [CDN 整合日誌分析參考](cdn-log-error-reference.md)
+ 如需呈報和取得其他協助，請參閱 [取得 CDN 整合支援](cdn-get-help.md)

## 故障診斷準備
<a name="troubleshooting-preparation"></a>

設定工具和程序，在發生 CDN 整合問題時簡化故障診斷。主動準備可讓故障診斷在發生問題時更快速且更有效率。

### 啟用完整記錄
<a name="enable-comprehensive-logging"></a>

詳細日誌對於診斷 CDN 整合問題至關重要。設定記錄以擷取疑難排解期間所需的資訊。

1. 啟用詳細 CDN 存取日誌：
   + 針對處理 MediaTailor 請求的所有快取行為設定記錄
   + 在日誌項目中包含查詢字串和自訂標頭
   + 設定日誌分析工具以識別模式和異常
   + 在即時事件期間啟用即時日誌以立即偵測問題
   + 設定日誌保留政策以維護歷史故障診斷資料

1. 設定 MediaTailor 記錄：
   + 為您的 MediaTailor 組態啟用存取日誌
   + 設定 CloudWatch 日誌群組以進行集中式日誌管理
   + 設定日誌篩選條件以識別錯誤模式

1. 設定原始伺服器記錄：
   + 在內容原始伺服器上啟用詳細存取日誌
   + 在日誌中包含請求標頭和回應代碼
   + 監控原始伺服器效能指標

### 新增診斷請求標頭
<a name="add-diagnostic-headers"></a>

自訂標頭可協助透過 CDN 追蹤請求，並識別路由問題。

1. 設定 CDN 診斷標頭：
   + 為每個請求新增唯一識別符 （例如 `X-Request-ID`)
   + 在請求標頭中包含 CDN 特定資訊
   + 新增節點或 POP （存在點） 資訊以追蹤地理路由
   + 包含快取行為分析的快取狀態標頭 (Hit、Miss、RefreshHit)

1. 新增用於偵錯的回應標頭：
   + 包含伺服器識別標頭
   + 新增用於效能分析的計時資訊
   + 包含資訊清單請求的快取控制標頭

### 建立基準效能指標
<a name="establish-baseline-metrics"></a>

記錄正常效能範圍，以便在故障診斷期間快速識別異常狀況：

1. **記錄基準指標**：
   + 快取不同內容類型的命中率
   + 回應時間百分位數 (P50、P95, P99)
   + 依狀態碼的錯誤率
   + 依時間請求磁碟區模式

1. **文件效能期望**：
   + 目標快取命中率 （內容為 95%\+，廣告為 90%\+)
   + 可接受的回應時間 (<100ms 快取、<500ms 原始伺服器）
   + 可接受的錯誤率上限 (4xx 為 <1%，5xx 為 <0.1%)

1. **建立效能儀表板**：設定監控儀表板，顯示與基準值相比的目前指標。

### 準備疑難排解工具
<a name="prepare-troubleshooting-tools"></a>

設定有效疑難排解所需的工具和存取許可：

1. **命令列工具**：
   + `curl` 用於測試 HTTP 請求和回應
   + `dig` 或 `nslookup` 進行 DNS 疑難排解
   + 用於資訊清單驗證的 HLS/DASH 驗證工具
   + 日誌分析工具 (grep、awk 或專用日誌分析器）

1. **存取許可**：
   + 組態檢閱的 CDN 管理主控台存取權
   + 用於組態驗證的 MediaTailor 主控台存取權
   + 指標和日誌分析的 CloudWatch 存取
   + 後端疑難排解的原始伺服器存取

1. **文件：**
   + 網路架構圖
   + CDN 和 MediaTailor 組態文件
   + 呈報程序的聯絡資訊
   + 針對常見案例的 Runbook 進行故障診斷

## 工作流程特定的疑難排解指南
<a name="workflow-specific-troubleshooting"></a>

此通用故障診斷指南涵蓋所有 MediaTailor CDN 整合的常見問題。對於特定工作流程或服務的特定問題，請參閱以下專門的故障診斷資源：

伺服器端廣告插入 (SSAI) 疑難排解  
如需 SSAI 特定的問題，包括廣告插入失敗、廣告轉換問題和個人化問題，請參閱工作流程特定的 SSAI 疑難排解文件。  
**常見 SSAI 特定問題**：  
+ 廣告插入失敗和空廣告休息時間
+ 廣告轉換時間和同步問題
+ 個人化和鎖定問題
+ 廣告追蹤和分析差異

通道組件疑難排解  
如需頻道組件特定的問題，包括資訊清單產生問題和時間轉移功能，請參閱頻道組件工作流程文件。  
**常見的頻道組件問題**：  
+ 資訊清單產生和編譯錯誤
+ 時間轉移時段和 DVR 功能問題
+ 來源內容可用性和容錯移轉問題
+ 程式排程和中繼資料同步

MediaPackage 整合疑難排解  
如需 MediaPackage 特定問題，包括資訊清單篩選和 EMP 端點問題，請參閱 [CDN 整合疑難排解](cdn-emp-troubleshooting.md)。  
**常見的 MediaPackage 整合問題**：  
+ 資訊清單篩選參數錯誤
+ MediaPackage 端點連線問題
+ EMP 特定的快取行為問題
+ MediaPackage 原始伺服器身分驗證問題

CloudFront 特定疑難排解  
如需 CloudFront 特定的組態和設定問題，請參閱 CloudFront 整合文件。  
**常見的 CloudFront 問題**：  
+ 分佈組態和快取行為設定
+ 原始存取身分和安全性組態
+ CloudFront 特定錯誤代碼和回應
+ 地理限制和邊緣位置問題

**其他資源**：
+ 如需效能最佳化指引，請參閱 [CDN 效能最佳化](cdn-optimization.md)
+ 如需監控和提醒設定，請參閱 [CDN 監控](cdn-monitoring.md)
+ 如需一般支援和協助，請參閱 [取得 CDN 整合支援](cdn-get-help.md)