기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# MediaTailor 및 CDN 통합 관련 문제 해결
이 포괄적인 문제 해결 가이드에서는 서버 측 광고 삽입(SSAI), 채널 어셈블리 및 통합을 포함한 모든 AWS Elemental MediaTailor 구현에서 일반적인 콘텐츠 전송 네트워크(CDN) 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)
## 문제 해결 준비
CDN 통합 문제가 발생할 때 문제 해결을 간소화하는 도구 및 프로세스를 설정합니다. 사전 대비를 통해 문제가 발생할 때 문제를 더 빠르고 효과적으로 해결할 수 있습니다.
### 포괄적인 로깅 활성화
CDN 통합 문제를 진단하려면 세부 로그가 필수적입니다. 문제 해결 중에 필요한 정보를 캡처하도록 로깅을 구성합니다.
1. 세부 CDN 액세스 로그 활성화:
+ MediaTailor 요청을 처리하는 모든 캐시 동작에 대한 로깅 구성
+ 로그 항목에 쿼리 문자열 및 사용자 지정 헤더 포함
+ 패턴과 이상을 식별하기 위한 로그 분석 도구 설정
+ 실시간 이벤트 중 즉각적인 문제 감지를 위한 실시간 로그 활성화
+ 기록 문제 해결 데이터를 유지 관리하도록 로그 보존 정책 구성
1. MediaTailor 로깅 구성:
+ MediaTailor 구성에 대한 액세스 로그 활성화
+ 중앙 집중식 로그 관리를 위한 CloudWatch 로그 그룹 설정
+ 오류 패턴을 식별하도록 로그 필터 구성
1. 오리진 서버 로깅 설정:
+ 콘텐츠 오리진 서버에서 세부 액세스 로그 활성화
+ 로그에 요청 헤더 및 응답 코드 포함
+ 오리진 서버 성능 지표 모니터링
### 진단 요청 헤더 추가
사용자 지정 헤더는 CDN을 통해 요청을 추적하고 라우팅 문제를 식별하는 데 도움이 됩니다.
1. CDN 진단 헤더 구성:
+ 각 요청에 고유 식별자 추가(예: `X-Request-ID`)
+ 요청 헤더에 CDN 관련 정보 포함
+ 엣지 로케이션 또는 POP(존재 지점) 정보를 추가하여 지리적 라우팅 추적
+ 캐시 동작 분석을 위한 캐시 상태 헤더(Hit, Miss, RefreshHit) 포함
1. 디버깅을 위한 응답 헤더 추가:
+ 서버 식별 헤더 포함
+ 성능 분석을 위한 타이밍 정보 추가
+ 매니페스트 요청에 대한 캐시 제어 헤더 포함
### 기준 성능 지표 설정
정상 성능 범위를 문서화하여 문제 해결 중에 이상을 빠르게 식별합니다.
1. **기준 지표를 기록합니다**.
+ 다양한 콘텐츠 유형에 대한 캐시 적중률
+ 응답 시간 백분위수(P50, P95, P99)
+ 상태 코드별 오류 발생률
+ 시간대별 요청 볼륨 패턴
1. **성능 기대치 문서화**:
+ 대상 캐시 적중률(콘텐츠의 경우 95% 이상, 광고의 경우 90% 이상)
+ 허용 가능한 응답 시간(캐싱된 <100ms, 오리진 <500ms)
+ 허용되는 최대 오류율(4xx의 경우 <1%, 5xx의 경우 <0.1%)
1. **성능 대시보드 생성**: 기준 값과 비교하여 현재 지표를 표시하는 모니터링 대시보드를 설정합니다.
### 문제 해결 도구 준비
효과적인 문제 해결에 필요한 도구 및 액세스 권한을 설정합니다.
1. **명령줄 도구**:
+ `curl` HTTP 요청 및 응답 테스트용
+ `dig` DNS 문제 해결을 `nslookup` 위한 또는
+ 매니페스트 확인을 위한 HLS/DASH 검증 도구
+ 로그 분석 도구(grep, awk 또는 특수 로그 분석기)
1. **액세스 권한**:
+ 구성 검토를 위한 CDN 관리 콘솔 액세스
+ 구성 확인을 위한 MediaTailor 콘솔 액세스
+ 지표 및 로그 분석을 위한 CloudWatch 액세스
+ 백엔드 문제 해결을 위한 오리진 서버 액세스
1. **설명서:**
+ 네트워크 아키텍처 다이어그램
+ CDN 및 MediaTailor 구성 설명서
+ 에스컬레이션 절차를 위한 연락처 정보
+ 일반적인 시나리오에 대한 런북 문제 해결
## 워크플로별 문제 해결 가이드
이 범용 문제 해결 가이드에서는 모든 MediaTailor CDN 통합의 일반적인 문제를 다룹니다. 특정 워크플로 또는 서비스와 관련된 문제는 다음 특수 문제 해결 리소스를 참조하세요.
서버 측 광고 삽입(SSAI) 문제 해결
광고 삽입 실패, 광고 전환 문제 및 개인화 문제를 포함한 SSAI 관련 문제는 워크플로별 SSAI 문제 해결 설명서를 참조하세요.
**일반적인 SSAI 관련 문제**:
+ 광고 삽입 실패 및 빈 광고 중단
+ 광고 전환 타이밍 및 동기화 문제
+ 개인화 및 대상 지정 문제
+ 광고 추적 및 분석 불일치
채널 어셈블리 문제 해결
매니페스트 생성 문제 및 시간 전환 기능을 포함한 채널 어셈블리 관련 문제는 채널 어셈블리 워크플로 설명서를 참조하세요.
**일반적인 채널 어셈블리 문제**:
+ 매니페스트 생성 및 컴파일 오류
+ 시간 전환 기간 및 DVR 기능 문제
+ 소스 콘텐츠 가용성 및 장애 조치 문제
+ 프로그램 일정 및 메타데이터 동기화
MediaPackage 통합 문제 해결
매니페스트 필터링 및 EMP 엔드포인트 문제를 포함한 MediaPackage 관련 문제는 섹션을 참조하세요[CDN 통합 문제 해결](cdn-emp-troubleshooting.md).
**일반적인 MediaPackage 통합 문제**:
+ 매니페스트 필터링 파라미터 오류
+ MediaPackage 엔드포인트 연결 문제
+ EMP별 캐시 동작 문제
+ MediaPackage 오리진 인증 문제
CloudFront 관련 문제 해결
CloudFront별 구성 및 설정 문제는 CloudFront 통합 설명서를 참조하세요.
**일반적인 CloudFront 문제**:
+ 배포 구성 및 캐시 동작 설정
+ 오리진 액세스 ID 및 보안 구성
+ CloudFront 관련 오류 코드 및 응답
+ 지리적 제한 및 엣지 로케이션 문제
**추가 리소스**:
+ 성능 최적화 지침은 섹션을 참조하세요. [CDN 성능 최적화](cdn-optimization.md)
+ 설정 모니터링 및 알림은 섹션을 참조하세요. [CDN 모니터링](cdn-monitoring.md)
+ 일반적인 지원 및 지원은 섹션을 참조하세요. [CDN 통합 지원 받기](cdn-get-help.md)