本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 对 CDN 集成 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（接入点）信息以跟踪地理路由
   + 包括缓存状态标头（命中、未命中、 RefreshHit），用于缓存行为分析

1. 添加用于调试的响应标头：
   + 包括服务器标识标头
   + 为性能分析添加计时信息
   + 包括清单请求的缓存控制标头

### 建立基准性能指标
<a name="establish-baseline-metrics"></a>

记录正常性能范围，以便在故障排除期间快速识别异常：

1. **记录基线指标**：
   + 不同内容类型的缓存命中率
   + 响应时间百分位数（P50、P95、P99）
   + 按状态码划分的错误率
   + 按一天中的时间请求音量模式

1. **记录绩效预期**：
   + 目标缓存命中率（内容命中率超过 95%，广告命中率超过 90%）
   + 可接受的响应时间（缓存 <100 毫秒，原点 <500 毫秒）
   + 最大可接受错误率（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 配置文档
   + 上报程序的联系信息
   + 常见场景的运行手册疑难解答

## 特定于工作流程的疑难解答指南
<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-monitoring.md)
+ 如需一般支持和帮助，请参阅 [获取 CDN 集成支持](cdn-get-help.md)