기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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)
# MediaTailor 및 CDN 통합을 위한 진단 체크리스트
AWS Elemental MediaTailor 콘텐츠 전송 네트워크(CDN) 통합 문제는 다양한 방식으로 나타날 수 있습니다. 이 체크리스트를 사용하여 발생하는 문제 유형을 빠르게 식별할 수 있습니다.
1. **문제가 모든 최종 사용자 또는 특정 최종 사용자에게 영향을 미치나요?**
+ 모든 뷰어 → 가능한 CDN 또는 MediaTailor 구성 문제
+ 특정 뷰어 → 개인화 또는 타겟팅 문제일 가능성이 높음
1. **매니페스트가 올바르게 로드되고 있습니까?**
+ 아니요 → CDN 라우팅 또는 MediaTailor 연결 문제
+ 예, 하지만 잘못된 콘텐츠 → 캐싱 또는 개인화 문제
1. **세그먼트가 올바르게 로드되고 있습니까?**
+ 콘텐츠 세그먼트 실패 → 오리진 연결 문제
+ 광고 세그먼트 실패 → 광고 전송 또는 트랜스코딩 문제
1. **광고가 올바르게 삽입되고 있습니까?**
+ 광고가 표시되지 않음 → ADS 연결 및 구성 확인
+ 잘못된 광고 표시 → 광고 대상 지정 파라미터 및 개인화 확인
+ 광고 재생 실패 → 광고 트랜스코딩 및 세그먼트 가용성 확인
1. **재생이 원활하고 중단되지 않나요?**
+ 버퍼링 문제 → CDN 캐시 성능 및 오리진 응답 시간 확인
+ 재생 오류 → 매니페스트 구문 및 세그먼트 가용성 확인
+ 광고 전환 문제 → 광고 중단 타이밍 및 세그먼트 정렬 확인
1. **특정 오류 코드 또는 메시지가 있습니까?**
+ HTTP 4xx 오류 → CDN 라우팅 및 구성 확인
+ HTTP 5xx 오류 → 오리진 서버 및 MediaTailor 서비스 상태 확인
+ 플레이어별 오류 → 매니페스트 형식 및 플레이어 호환성 확인
**진단에 따른 다음 단계:**
CDN 구성 문제
CDN 라우팅 및 캐싱 문제 해결에 대한 자세한 내용은 섹션을 참조하세요[MediaTailor 및 CDN 통합 관련 문제 해결](cdn-troubleshooting.md).
매니페스트 및 재생 문제
매니페스트 검증 및 재생 문제 해결은 섹션을 참조하세요[CDN 통합 테스트 절차](cdn-testing-procedures.md).
광고 삽입 및 타겟팅 문제
ADS 연결 및 광고 전송을 포함한 광고별 문제 해결은 워크플로별 문제 해결 설명서를 참조하세요.
성능 및 모니터링 문제
성능 분석 및 모니터링 설정은 섹션을 참조하세요[MediaTailor CDN 작업 및 성능 모니터링](cdn-monitoring.md).
로그 분석 및 오류 코드
자세한 로그 분석 및 오류 코드 참조는 섹션을 참조하세요[MediaTailor에 대한 CDN 통합 로그 분석 및 오류 코드 참조](cdn-log-error-reference.md).
테스트 및 검증
포괄적인 테스트 절차는 섹션을 참조하세요[CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md).
즉각적인 지원이 필요하거나 연결된 리소스를 사용하여 문제를 해결할 수 없는 경우 에스컬레이션 절차는 섹션을 참조[CDN 및 MediaTailor 통합에 대한 지원 및 문제 해결 도움말 받기](cdn-get-help.md)하세요.
# CDN 통합 테스트 절차
MediaTailor CDN 통합을 프로덕션에 배포하기 전에 적절한 테스트가 필수적입니다. 이러한 테스트 절차는 다양한 디바이스 및 플랫폼에서 구성 문제, 성능 문제 및 호환성 문제를 식별하는 데 도움이 됩니다.
## 기본 통합 검증
다음 기본 테스트를 수행하여 CDN 통합이 올바르게 작동하는지 확인합니다.
1. 매**니페스트 전송 테스트**:
+ CDN을 통해 매니페스트를 요청하고 유효한 응답을 반환하는지 확인합니다.
+ 매니페스트에 예상 콘텐츠와 광고 삽입 지점이 포함되어 있는지 확인합니다.
+ 매니페스트 URLs이 아닌 CDN 도메인을 사용하는지 확인
+ HLS 또는 DASH 검증 도구를 사용하여 매니페스트 구문 검증
1. **URL 재작성 확인**:
+ 매니페스트의 콘텐츠 세그먼트 URLs이 CDN 도메인을 가리키는지 확인
+ 광고 세그먼트 URLs CDN 도메인을 가리키는지 확인
+ 모든 관련 URLs 제대로 확인되었는지 확인
1. **콘텐츠 재생 테스트**:
+ 비디오 플레이어를 통해 콘텐츠 재생 및 원활한 재생 확인
+ 콘텐츠와 광고가 중단 없이 재생되는지 확인
+ 콘텐츠와 광고 간의 적절한 전환 확인
+ 탐색 및 스크러빙 기능 테스트
1. **CDN 라우팅 검증**:
+ CDN 액세스 로그를 모니터링하여 요청이 올바르게 라우팅되었는지 확인합니다.
+ 캐시 적중/누락 패턴이 예상대로인지 확인
+ 오리진 요청이 캐시 누락에 대해서만 발생하는지 확인
## 고급 테스트 절차
포괄적인 검증을 위해 다음 추가 테스트를 수행합니다.
1. **교차 플랫폼 호환성 테스트**:
+ 여러 디바이스(데스크톱, 모바일, 태블릿, 스마트 TV)에서 테스트
+ 여러 브라우저 간의 호환성 확인
+ 다양한 비디오 플레이어(HLS.js, Video.js, 네이티브 플레이어)로 테스트
+ 다양한 운영 체제에서 검증
1. **성능 테스트**:
+ 매니페스트 요청 응답 시간 측정(대상: 캐시된 경우 <100ms)
+ 다양한 비트 전송률에서 세그먼트 로드 성능 테스트
+ 시작 시간이 성능 목표를 충족하는지 확인
+ 다양한 네트워크 조건에서 테스트
1. **광고 추적 검증**:
+ 광고 추적 비컨이 올바르게 실행되는지 확인
+ 광고 분석 데이터의 정확성 확인
+ 노출 및 완료 추적 테스트
+ 클릭 기능 검증
1. **오류 조건 테스트**:
+ 오리진을 일시적으로 사용할 수 없는 경우 동작 테스트
+ 잘못된 형식의 요청에 대한 정상적인 처리 확인
+ CDN 장애 조치 시나리오 테스트
+ 오류 메시지의 명확성과 유용성 검증
## 테스트 환경 생성
포괄적인 검증을 위해 프로덕션 구성을 미러링하는 테스트 환경을 설정합니다.
1. 테스트를 위해 별도의 CDN 배포를 설정합니다.
+ 프로덕션과 동일한 캐시 동작으로 테스트 CDN 배포 생성
+ 프로덕션 설정을 미러링하는 테스트 오리진 구성
+ 별도의 도메인 이름을 사용하여 프로덕션 트래픽과의 충돌 방지
1. 테스트 MediaTailor 구성을 생성합니다.
+ 프로덕션과 동일한 설정으로 테스트 재생 구성 설정
+ 테스트 광고 결정 서버 엔드포인트 구성
+ 프로덕션 광고 형식과 일치하는 테스트 광고 콘텐츠 사용
1. 체계적인 테스트 프로세스를 구현합니다.
+ 구성 변경에 대한 테스트 체크리스트 생성
+ 팀의 테스트 절차 문서화
+ 가능한 경우 자동 테스트 설정
## 여러 시나리오에서 테스트
다양한 시나리오 및 조건에서 통합을 검증하여 포괄적인 적용 범위를 보장합니다.
1. 여러 플레이어 유형 및 디바이스로 테스트:
+ 다양한 비디오 플레이어(웹, 모바일, 연결된 TV)로 테스트
+ 다양한 운영 체제 및 브라우저에서 검증
+ 다양한 네트워크 조건 및 연결 속도에 대한 테스트
1. 자동 테스트 스크립트 생성:
+ 매니페스트 요청 검증 자동화
+ 스크립트를 생성하여 광고 삽입 시나리오 테스트
+ 트래픽이 많은 시나리오에 대한 성능 테스트 구현
1. 광고 타겟팅 및 개인화 검증:
+ 다양한 사용자 프로필 및 대상 지정 파라미터로 테스트
+ 광고 결정 서버 통합 검증
+ 광고를 사용할 수 없을 때 대체 시나리오 테스트
## 도구 및 기법 테스트
효과적인 테스트를 위해 다음 도구와 기법을 사용합니다.
브라우저 개발자 도구
네트워크 탭을 사용하여 HTTP 요청 및 응답 검사
콘솔에서 JavaScript 오류 및 경고 모니터링
응답 헤더 및 캐싱 동작 확인
성능 분석을 위한 타이밍 정보 확인
명령줄 테스트
curl을 사용하여 특정 URLs 테스트하고 헤더를 검사합니다.
```
curl -I "https://your-cdn-domain.com/path/to/manifest.m3u8"
```
테스트 및 타이밍 분석 다운로드에 wget 사용
보다 읽기 쉬운 HTTP 테스트를 위해 httpie와 같은 도구 사용
비디오 플레이어 테스트
여러 플레이어 구현으로 테스트
플레이어 디버그 모드를 사용하여 내부 동작 검사
플레이어 이벤트 및 오류 콜백 모니터링
적응형 비트 전송률 전환 동작 검증
CDN 분석 및 모니터링
테스트 중 실시간 CDN 지표 모니터링
요청 패턴에 대한 액세스 로그 검토
사용 가능한 경우 CDN별 테스트 도구 사용
테스트 검증을 위한 임시 알림 설정
추가적인 포괄적인 테스트 방법론 및 체계적인 검증 접근 방식은 섹션을 참조하세요[CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md).
# MediaTailor의 CDN 매니페스트 404 오류 문제 해결
AWS Elemental MediaTailor 콘텐츠 전송 네트워크(CDN) 매니페스트 404 오류는 재생을 시작하지 못하게 하는 일반적인 통합 문제입니다. 이 섹션에서는 매니페스트 전송 실패에 대한 step-by-step 문제 해결을 제공합니다.
다변량 재생 목록, 미디어 재생 목록 또는 MPD 요청은 404 오류를 반환합니다.
**빠른 수정(먼저 시도):**
1. URL의 MediaTailor 구성 이름이 정확히 일치하는지 확인(대/소문자 구분)
1. CDN이 없는 MediaTailor에 대해 매니페스트 URL을 직접 테스트합니다. `curl -v "https://your-emt-endpoint.mediatailor.region.amazonaws.com/v1/master/hls/config-name/master.m3u8"`
1. 직접 테스트가 작동하는 경우 매니페스트 요청에 대한 CDN 라우팅 규칙 확인
**빠른 수정이 작동하지 않는 경우:**
**증상:** 플레이어가 재생을 시작하지 못하고 매니페스트 요청이 CDN 로그에 HTTP 404 오류를 반환합니다.
**오류 메시지의 예:**
+ 브라우저 콘솔: `"Failed to load resource: the server responded with a status of 404 (Not Found)"`
+ 플레이어 오류: `"MANIFEST_LOAD_ERROR"` 또는 `"NETWORK_ERROR"`
+ CDN 로그: `GET /v1/master/hls/example-config/master.m3u8 404`
**해결 방법:**
CDN 라우팅 규칙이 다변량 재생 목록, 미디어 재생 목록 및 MPD 요청을 MediaTailor로 전달하도록 올바르게 구성되어 있는지 확인합니다.
MediaTailor 구성이 존재하고 올바르게 설정되었는지 확인합니다.
CDN 동작 패턴이 예상 매니페스트 요청 경로(예: , `*.m3u8``*.mpd`)와 일치하는지 확인합니다.
# MediaTailor에 대한 CDN 매니페스트 전송 문제 및 오류 진단
AWS Elemental MediaTailor 콘텐츠 전송 네트워크(CDN) 매니페스트 전송 문제는 적절한 광고 삽입 및 재생을 방해할 수 있습니다. 최종 사용자가 다변량 재생 목록, 미디어 재생 목록 또는 MPDs에서 잘못되거나 일관되지 않은 광고를 수신하는 경우:
1. 캐시된 매니페스트 확인:
+ 모든 다변량 재생 목록, 미디어 재생 목록 및 MPD 경로에 대해 TTL 설정이 0으로 설정되어 있는지 확인
+ TTL 설정에도 불구하고 CDN이 다변량 재생 목록, 미디어 재생 목록 또는 MPDs를 캐싱하지 않는지 확인
+ CDN 로그에서 캐시 상태 확인 - 매니페스트 요청은 `Miss` 또는를 표시해야 하며 `RefreshHit` `Hit`
1. CDN 라우팅 구성을 확인합니다.
+ 매니페스트 요청이 오리진에서 캐싱되거나 제공되지 않고 MediaTailor 엔드포인트로 라우팅되고 있는지 확인
+ CDN 동작 패턴이 매니페스트 경로(\$1.m3u8, \$1.mpd)와 올바르게 일치하는지 확인합니다.
+ 쿼리 파라미터가 개인화를 위해 MediaTailor로 전달되고 있는지 확인
+ MediaTailor에 대해 매니페스트 URLs 직접 테스트하여 CDN과 서비스 문제를 격리합니다.
1. 헤더 전달 구성을 확인합니다.
+ 필요한 헤더가 전달되고 있는지 확인( 참조[MediaTailor CDN 통합에 필요한 헤더](cdn-configuration.md#cdn-required-headers))
+ 디바이스별 광고 타겟팅을 위해 사용자 에이전트 헤더가 전달되었는지 확인
+ 지리 대상 지정을 위해 X-Forwarded-For 헤더가 전달되었는지 확인
+ 압축 지원을 위해 Accept-Encoding 헤더가 전달되었는지 확인
1. 매니페스트 콘텐츠 및 구조를 검증합니다.
+ 매니페스트에 예상 광고 삽입 마커가 포함되어 있는지 확인(HLS의 경우EXT-X-CUE-OUT/IN)
+ 매니페스트의 세그먼트 URLs 오리진 도메인이 아닌 CDN 도메인을 사용하는지 확인
+ 광고 세그먼트가 제대로 삽입되고 액세스 가능한지 확인
+ 검증 도구를 사용하여 매니페스트 구문 테스트(HLS의 경우ffprobe, DASH의 경우 mp4box)
1. 다양한 시나리오를 테스트합니다.
+ 다른 세션 IDs로 테스트하여 개인 맞춤이 작동하는지 확인
+ 다양한 지리적 위치에서 테스트하여 지리적 대상 확인
+ 다양한 User-Agent 문자열로 테스트하여 디바이스 대상 확인
+ CDN이 있는 매니페스트 응답과 없는 매니페스트 응답을 비교하여 차이점 식별
**추가 문제 해결 리소스:**
+ 자세한 CDN 캐싱 구성은 섹션을 참조하세요. [CDN 및 MediaTailor 통합을 위한 캐싱 최적화](cdn-optimize-caching.md)
+ 포괄적인 CDN 라우팅 설정은 섹션을 참조하세요. [MediaTailor에 대한 CDN 라우팅 동작 설정](cdn-routing-behaviors.md)
+ 헤더 전달 요구 사항은 섹션을 참조하세요. [MediaTailor CDN 통합에 필요한 헤더](cdn-configuration.md#cdn-required-headers)
+ 로그 분석 및 오류 코드는 섹션을 참조하세요. [MediaTailor에 대한 CDN 통합 로그 분석 및 오류 코드 참조](cdn-log-error-reference.md)
+ 테스트 절차 및 검증은 섹션을 참조하세요. [CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md)
**성공 기준:** 해결되면 플레이어가 정상적으로 재생을 시작하고 광고가 예상대로 표시되어야 합니다. 매니페스트 요청은 CDN 로그에 HTTP 200 상태 코드를 반환해야 하며 매니페스트에는 적절하게 개인화된 광고 콘텐츠가 포함되어야 합니다.
# MediaTailor의 CDN 세그먼트 전송 및 로드 문제 해결
AWS Elemental MediaTailor 콘텐츠 전송 네트워크(CDN) 세그먼트 전송 문제로 인해 버퍼링 및 재생이 중단될 수 있습니다. 플레이어가 세그먼트를 로드하거나 버퍼링을 경험할 수 없는 경우:
1. CDN 라우팅 규칙 확인:
+ 콘텐츠 세그먼트가 올바른 오리진으로 라우팅되고 있는지 확인
+ 광고 세그먼트가 올바른 MediaTailor 광고 스토리지 위치로 라우팅되고 있는지 확인
+ 세그먼트 파일 확장명이 CDN 동작 패턴과 일치하는지 확인
+ 매니페스트URLs이 올바른 CDN 도메인을 사용하는지 확인
+ 라우팅 및 동작 경로 패턴 설정에 대한 자세한 지침은 섹션을 참조하세요. [MediaTailor에 대한 CDN 라우팅 동작 설정](cdn-routing-behaviors.md)
1. CORS 구성 확인:
+ 웹 플레이어의 경우 CDN이 CORS 헤더를 통과하거나 올바르게 설정되었는지 확인합니다.
+ 브라우저 개발자 도구를 사용하여 테스트하여 CORS 관련 오류 식별
+ preflight OPTIONS 요청이 올바르게 처리되었는지 확인
1. 세그먼트 접근성 및 성능 테스트:
+ 개별 세그먼트 URLs 직접 테스트하여 액세스할 수 있는지 확인
+ 세그먼트 응답 시간 확인 및 성능 병목 현상 식별
+ 세그먼트 파일 크기가 대역폭 대상에 적합한지 확인
+ 서로 다른 지리적 위치에서 세그먼트 로드 테스트
1. 세그먼트에 대한 CDN 캐싱 동작을 검증합니다.
+ 콘텐츠 세그먼트에 적절한 TTL 설정이 있는지 확인(일반적으로 매니페스트보다 김)
+ 광고 세그먼트가 개인화 요구 사항에 따라 적절하게 캐시되었는지 확인
+ 콘텐츠 및 광고 세그먼트 모두에 대한 캐시 적중률 모니터링
+ 캐시 키에 캐시 효율성을 줄이는 불필요한 파라미터가 포함되어 있지 않은지 확인합니다.
1. 오리진 서버 연결 및 상태 확인:
+ 오리진 서버가 세그먼트 요청에 올바르게 응답하는지 확인
+ 로드 중인 오리진 서버 용량 및 응답 시간 확인
+ 오리진 서버에 사용 가능한 예상 세그먼트 파일이 있는지 확인
+ 여러 오리진이 구성된 경우 오리진 장애 조치 시나리오 테스트
1. 광고 세그먼트별 문제 해결:
+ MediaTailor에서 광고 세그먼트가 제대로 트랜스코딩되고 사용 가능한지 확인
+ 매니페스트에서 광고 세그먼트 URLs 올바르게 생성되었는지 확인
+ 다양한 광고 대상 지정 파라미터로 광고 세그먼트 로드 테스트
+ 세그먼트를 사용할 수 없게 만들 수 있는 광고 트랜스코딩 지연 모니터링
1. 플레이어 호환성 및 동작을 검증합니다.
+ 다양한 플레이어 유형 및 버전으로 세그먼트 로드 테스트
+ 플레이어 버퍼 설정 및 세그먼트 요청 패턴 확인
+ 실패한 세그먼트 요청에 대한 플레이어 오류 처리 확인
+ 적응형 비트 전송률 전환 및 세그먼트 선택 로직 테스트
**추가 문제 해결 리소스:**
+ CDN 라우팅 및 동작 구성은 섹션을 참조하세요. [MediaTailor에 대한 CDN 라우팅 동작 설정](cdn-routing-behaviors.md)
+ CDN 캐싱 최적화는 섹션을 참조하세요. [CDN 및 MediaTailor 통합을 위한 캐싱 최적화](cdn-optimize-caching.md)
+ CORS 구성 지침은 섹션을 참조하세요. [MediaTailor에 대한 CDN 통합 보안 모범 사례](cdn-security-best-practices.md)
+ 성능 모니터링 및 분석은 섹션을 참조하세요. [MediaTailor CDN 작업 및 성능 모니터링](cdn-monitoring.md)
+ 포괄적인 테스트 절차는 섹션을 참조하세요. [CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md)
+ 로그 분석 및 오류 진단은 섹션을 참조하세요. [MediaTailor에 대한 CDN 통합 로그 분석 및 오류 코드 참조](cdn-log-error-reference.md)
**성공 기준:** 해결되면 플레이어는 버퍼링 중단 없이 세그먼트를 원활하게 로드해야 합니다. 세그먼트 요청은 적절한 응답 시간과 함께 HTTP 200 상태 코드를 반환해야 하며 콘텐츠 및 광고 세그먼트 모두에 액세스하고 적절하게 캐싱해야 합니다.
# MediaTailor에 대한 CDN 세션 관리 및 추적 문제 해결
AWS Elemental MediaTailor 콘텐츠 전송 네트워크(CDN) 세션 관리는 적절한 광고 개인화 및 추적에 매우 중요합니다. 요청 간에 세션 관련 오류 또는 일관되지 않은 동작이 발생하는 경우:
1. 세션 ID 일관성을 확인합니다.
+ 플레이어가 단일 재생 세션에 대한 모든 요청에서 동일한 세션 ID를 유지하는지 확인
+ CDN 로그를 확인하여 세션 IDs 올바르게 전달되고 있는지 확인합니다.
+ 쿼리 파라미터에서 세션 IDs 제대로 URL 인코딩되었는지 확인
+ CloudWatch Logs를 사용하여 요청 간 세션 ID 일관성을 확인합니다(아래 검증 단계 참조).
1. 세션 초기화 검증:
+ 첫 번째 매니페스트 요청이 세션을 성공적으로 생성하는지 확인
+ 적절한 세션 파라미터 전달 확인(예: `aws.sessionId`)
+ 디버그 로그를 사용하여 세션 초기화 확인(아래 디버그 로그 설정 참조)
1. 자세한 세션 문제 해결을 위해 디버그 로깅을 활성화합니다.
+ **서버 측 보고의 경우:** 재생 요청에 `?aws.logMode=DEBUG` 추가:
```
GET /v1/master///?aws.logMode=DEBUG
```
+ **클라이언트 측 보고의 경우:** 세션 초기화 요청 본문`"logMode": "DEBUG"`에 포함
+ **중요:** `DEBUG` 값은 대/소문자를 구분합니다.
+ 동시에 허용되는 최대 10개의 활성 디버그 세션
1. CloudWatch Logs 쿼리를 사용하여 세션 동작을 검증합니다.
+ **디버그 세션이 활성 상태인지 확인합니다.**
```
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
```
+ **세션의 모든 이벤트 보기:**
```
fields @timestamp, @message, eventType, mediaTailorPath
| filter sessionId = "your-session-id-here"
| sort @timestamp asc
```
+ **세션의 매니페스트 생성을 확인합니다.**
```
fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "your-session-id-here"
```
1. CDN을 통한 세션 파라미터 전달 테스트:
+ MediaTailor에 직접 세션 파라미터를 사용하여 매니페스트 요청 테스트(CDN 우회)
+ CDN이 있는 세션 동작과 없는 세션 동작을 비교하여 전달 문제 식별
+ CDN 쿼리 파라미터 전달 구성에 세션 관련 파라미터가 포함되어 있는지 확인
+ CDN이 세션별 응답을 캐싱하지 않는지 확인
**일반적인 세션 오류 메시지:**
+ `ConflictException` (HTTP 409) - 동일한 세션에 대한 여러 동시 재생 목록 요청입니다. **해결 방법:** 플레이어가 HLS 사양에 따라 한 번에 하나씩 재생 목록을 요청하는지 확인합니다.
+ `NotFoundException` (HTTP 404) - 세션을 사용할 수 없거나 구성이 존재하지 않습니다. **해결 방법:** 구성 유효성을 확인하고 세션을 다시 초기화합니다.
+ `BadRequestException` (HTTP 400) - 잘못된 세션 ID 또는 잘못된 형식의 요청입니다. **해결 방법:** 요청 형식 및 세션 ID 유효성 확인
**추가 문제 해결 리소스:**
+ 전체 디버그 로깅 설정 및 필드 참조는 섹션을 참조하세요. [AWS Elemental MediaTailor 디버그 로그 생성](debug-log-mode.md)
+ CloudWatch Logs 쿼리 예제 및 로그 분석은 섹션을 참조하세요. [Amazon CloudWatch Logs에 직접 AWS Elemental MediaTailor 로그 작성](monitoring-cw-logs.md)
+ CDN 쿼리 파라미터 전달 구성은 섹션을 참조하세요. [MediaTailor에 대한 CDN 라우팅 동작 설정](cdn-routing-behaviors.md)
+ 포괄적인 오류 코드 참조는 섹션을 참조하세요. [MediaTailor에서 재생 문제 해결](playback-errors.md)
**성공 기준:** 해결되면 세션이 올바르게 초기화되고, 요청 간에 일관된 세션 IDs 유지하며, 디버그 로그에 오류 없이 적절한 `SESSION_INITIALIZED` 이벤트와 매니페스트 생성이 표시되어야 합니다.
# MediaTailor의 CDN 광고 중단 타이밍 및 동기화 문제 해결
AWS Elemental MediaTailor 콘텐츠 전송 네트워크(CDN) 광고 중단 타이밍은 콘텐츠 마커와 정확하게 동기화되어야 합니다. 광고가 잘못된 시간에 나타나거나 광고 중단 시간이 일치하지 않는 경우:
1. 콘텐츠에서 광고 중단 마커를 확인합니다.
+ SCTE-35 마커가 오리진 콘텐츠에 올바르게 배치되었는지 확인
+ 광고 중단 기간이 실제 광고 콘텐츠 길이와 일치하는지 확인
+ 광고 시간 타이밍이 콘텐츠 경계와 일치하는지 확인
+ 오리진 매니페스트에서 SCTE-35 마커 형식 및 타이밍 정확도 검증
+ 다양한 콘텐츠 유형(라이브 대 VOD)으로 광고 중단 마커 테스트
1. CDN 캐싱이 타이밍에 미치는 영향을 확인합니다.
+ 타이밍 드리프트를 방지하려면 매니페스트 TTL이 0으로 설정되어 있는지 확인합니다.
+ 시간에 민감한 파라미터가 캐시되지 않는지 확인
+ 콘텐츠 소스, MediaTailor 및 CDN 간의 클럭 동기화 문제 확인
+ 장기 실행 라이브 스트림의 타이밍 드리프트 모니터링
+ NTP와 CDN 엣지 서버 시간 동기화 확인
1. SCTE-35 마커 구현 검증:
+ EXT-X-DATERANGE 태그에 적절한 SCTE35-OUT 및 DURATION 사양이 포함되어 있는지 확인
+ 명시적 큐인 타이밍을 사용할 때 페어링된 SCTE35-OUT 및 SCTE35-IN 마커 확인
+ START-DATE 타임스탬프가 실제 콘텐츠 타이밍과 일치하는지 확인
+ 다양한 SCTE-35 마커 형식 테스트(기간 기반 마커와 페어링된 마커)
1. 다양한 시나리오에서 광고 중단 타이밍을 테스트합니다.
+ 광고 중단 타이밍을 직접 MediaTailor 요청과 CDN 요청 비교
+ 다양한 CDN 엣지 로케이션에서 타이밍 일관성 테스트
+ 다양한 플레이어 유형 및 버퍼링 동작으로 광고 중단 타이밍 확인
+ 트래픽이 가장 많은 기간 동안 타이밍 정확도 모니터링
1. 로그 및 모니터링을 사용하여 타이밍 문제를 디버깅합니다.
+ 디버그 로깅을 활성화하여 광고 중단 처리 타이밍 추적
+ CloudWatch 지표에서 광고 삽입 타이밍 패턴 모니터링
+ CDN 로그에서 타이밍 관련 요청 패턴 확인
+ 플레이어 디버깅 도구를 사용하여 클라이언트 관점에서 광고 중단 타이밍 확인
**예상 타이밍 허용치:**
+ 광고 중단 타이밍은 콘텐츠의 SCTE-35 마커와 일치해야 합니다.
+ 광고 기간은 광고 결정 서버 응답에 지정된 기간과 일치해야 합니다.
+ 콘텐츠 소스, MediaTailor 및 CDN 간의 클록 동기화는 1초 이내여야 합니다.
+ SCTE-35 마커 타이밍은 실제 콘텐츠 타이밍의 100ms 이내로 정확해야 합니다.
**추가 문제 해결 리소스:**
+ SCTE-35 마커 형식 및 구현은 섹션을 참조하세요. [MediaTailor 광고 삽입을 위한 콘텐츠 소스 통합](integrating-origin.md)
+ 디버그 로깅 설정 및 타이밍 분석은 섹션을 참조하세요. [AWS Elemental MediaTailor 디버그 로그 생성](debug-log-mode.md)
+ CDN 캐싱 구성 및 타이밍 영향은 섹션을 참조하세요. [CDN 및 MediaTailor 통합을 위한 캐싱 최적화](cdn-optimize-caching.md)
+ 타이밍 검증을 포함한 포괄적인 테스트 절차는 섹션을 참조하세요. [CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md)
+ 광고 삽입 타이밍 및 성능 모니터링은 섹션을 참조하세요. [MediaTailor CDN 작업 및 성능 모니터링](cdn-monitoring.md)
**성공 기준:** 해결되면 모든 CDN 엣지 로케이션 및 플레이어 유형에서 일관된 타이밍으로 SCTE-35 마커에 지정된 시간에 광고 시간이 정확하게 표시되어야 합니다. 디버그 로그에는 드리프트 또는 동기화 오류 없이 정확한 광고 중단 처리 타이밍이 표시되어야 합니다.
# MediaTailor의 CDN 성능 최적화 및 지연 시간 문제 해결
AWS Elemental MediaTailor 콘텐츠 전송 네트워크(CDN) 통합 성능은 최종 사용자 경험과 광고 전송 품질에 직접적인 영향을 미칩니다. 응답 시간이 느리거나 성능이 저하되는 경우:
## 성능 측정 기법
성능 문제를 해결하기 전에 기준 측정 및 지속적인 모니터링을 설정합니다.
1. 주요 성능 지표 측정:
+ **응답 시간:** 매니페스트 요청은 200ms 이내에 완료되고, 세그먼트 요청은 100ms 이내에 완료되어야 합니다.
+ **캐시 적중률:** 콘텐츠 세그먼트 >95%, 광고 세그먼트 >90%
+ **오리진 요청 볼륨:** 캐시가 최적화될 때 총 요청의 5% 미만이어야 합니다.
+ **첫 번째 프레임까지의 시간:** 초기 재생이 2\$13초 이내에 시작되어야 합니다.
1. 성능 측정 도구를 사용합니다.
+ **CDN 분석 대시보드:** 캐시 성능, 응답 시간 및 오류율 모니터링
+ **CloudWatch 지표:** GetManifest.Latency를 포함한 MediaTailor 서비스 지표 추적
+ **브라우저 개발자 도구:** 클라이언트 측 성능 및 네트워크 타이밍 측정
+ **명령줄 도구:** 타이밍 옵션과 함께 curl을 사용하여 특정 요청 측정
1. 지속적인 모니터링 구현:
+ 응답 시간 저하에 대한 자동 성능 알림 설정
+ 다양한 지리적 리전에서 성능 모니터링
+ 트래픽이 가장 많은 기간 동안 성능 추적
+ 구성 변경 전후의 성능 지표 비교
**성능 측정 리소스:**
+ 포괄적인 성능 모니터링 설정은 섹션을 참조하세요. [MediaTailor CDN 작업 및 성능 모니터링](cdn-monitoring.md)
+ 성능 테스트 절차는 섹션을 참조하세요. [CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md)
+ CloudWatch 지표 및 모니터링은 섹션을 참조하세요. [Amazon CloudWatch 지표 AWS Elemental MediaTailor 를 사용한 모니터링](monitoring-cloudwatch-metrics.md)
## CDN 캐시 성능 문제
캐시 성능 문제는 가장 일반적인 CDN 통합 문제 중 하나입니다. 이러한 문제는 모든 MediaTailor 구현에 영향을 미치며 최종 사용자 경험과 비용에 상당한 영향을 미칠 수 있습니다.
**낮은 캐시 적중률**
**증상**: 오리진 요청 볼륨 높음, 지연 시간 증가, 대역폭 비용 증가, 시청자 경험 저하
**대상 값**:
+ 콘텐츠 세그먼트: 캐시 적중률 95% 이상
+ 광고 세그먼트: 캐시 적중률 90% 이상
+ 매니페스트: 구현에 따라 다름(개인화된 매니페스트는 캐시해서는 안 됨)
**일반적인 원인:**
+ 다양한 콘텐츠 유형에 대한 잘못된 TTL 설정
+ 캐시 키 구성에 불필요한 쿼리 파라미터 포함
+ 오리진의 캐시 제어 헤더가 제대로 구성되지 않음
+ 빈번한 캐시 무효화 또는 제거
+ 지리적 배포 문제(엣지 로케이션에 캐싱되지 않은 콘텐츠)
**솔루션:**
1. TTL 설정을 검토하고 최적화합니다.
+ 콘텐츠 세그먼트: 세그먼트 기간 이상과 일치하도록 TTL 설정
+ 광고 세그먼트: 재사용 가능한 광고의 경우 TTL을 24시간 이상으로 설정
+ 정적 자산: TTL을 24시간 이상으로 설정
포괄적인 TTL 권장 사항 및 캐싱 최적화 전략은 섹션을 참조하세요[CDN 및 MediaTailor 통합을 위한 캐싱 최적화](cdn-optimize-caching.md).
1. 캐시 키 구성 최적화:
+ 캐시 키에서 불필요한 쿼리 파라미터 제거
+ 콘텐츠에 영향을 미치는 파라미터만 포함되도록 합니다.
+ 파라미터 순서 및 대/소문자 구분 정규화
1. 오리진 캐시 제어 헤더가 올바르게 설정되었는지 확인
1. 트래픽이 많은 구현을 위해 오리진 실드(또는 이에 상응하는 CDN 기능)를 구현합니다. 오리진 실드 기능은 주요 CDNs에서 사용할 수 있지만 이름이 다를 수 있습니다(예: CloudFront Origin Shield, Fastly Shield, Cloudflare Argo 계층형 캐시). CDN에서이 기능을 제공하지 않는 경우 [AWS Support](https://aws.amazon.com/premiumsupport/)에 문의할 때 MediaTailor에서 활성화할 수 있습니다.
1. 캐시 무효화 전략 검토 및 불필요한 제거 감소
**검증 단계**:
1. CDN 분석 대시보드를 사용하여 캐시 적중률 모니터링
1. curl을 사용하여 특정 URLs을 테스트하여 캐시 헤더 확인
1. 변경 전후의 오리진 요청 볼륨 비교
**높은 오리진 요청 볼륨**
**증상**: MediaTailor 오리진에 도달하는 요청 수가 예기치 않게 많음, 오리진 서버 로드 증가, 비용 증가
**예상 패턴**: 캐시 적중률이 최적일 때 오리진 요청은 총 최종 사용자 요청의 5% 미만이어야 합니다.
**일반적인 원인:**
+ 낮은 TTL 값으로 인한 캐시 누락
+ 캐시 키 조각화(고유 캐시 키가 너무 많음)
+ 캐싱된 콘텐츠가 없는 리전의 지리적 트래픽 급증
+ 빈번한 캐시 무효화
**솔루션:**
1. 요청 패턴을 분석하여 캐시 누락 원인 식별
1. 콘텐츠 유형 및 업데이트 빈도에 따라 TTL 설정 최적화
1. 새 콘텐츠에 대한 캐시 워밍 전략 구현
1. 오CDNs에서 사용 가능 - [Origin Shield 구현](cdn-advanced-optimization.md#origin-shield-optimization) 자세한 내용은 참조)
**알림 임계값**: 오리진 요청이 총 요청의 10%를 초과하거나 기준보다 50% 증가할 때 알림을 설정합니다.
## 일반적인 HTTP 오류 해결
CDN 통합의 HTTP 오류는 구성 문제 또는 서비스 문제를 나타내는 경우가 많습니다. 이러한 오류 패턴은 모든 MediaTailor 구현에서 일관됩니다.
**404 찾을 수 없음 오류**
**증상**: 매니페스트 또는 세그먼트 요청은 HTTP 404를 반환하고, 플레이어는 콘텐츠를 로드하지 못합니다. 플레이어 로그에서 "MANIFEST\$1LOAD\$1ERROR"
**일반적인 원인:**
+ 잘못된 CDN 오리진 구성(잘못된 MediaTailor 엔드포인트 URL)
+ 누락되거나 잘못된 캐시 동작 경로 패턴
+ CDN 구성의 URL 재작성 문제
+ MediaTailor 구성 이름 또는 재생 엔드포인트 오류
+ 라이브 콘텐츠의 타이밍 문제(향후 세그먼트 요청)
**진단 단계:**
1. MediaTailor 오리진에 대해 직접 동일한 URL 테스트(CDN 우회)
1. CDN 오리진 구성이 MediaTailor 재생 엔드포인트와 일치하는지 확인
1. CDN 캐시 동작 경로 패턴 및 우선 순위 확인
1. CDN 액세스 로그에서 요청 라우팅 세부 정보 검토
1. MediaTailor 구성 이름 및 리전 설정 검증
**솔루션:**
+ MediaTailor 재생 엔드포인트와 일치하도록 CDN 오리진 구성 수정
+ 캐시 동작 경로 패턴을 업데이트하여 요청을 올바르게 라우팅합니다.
+ 해당하는 경우 URL 재작성 규칙 수정
+ MediaTailor 구성이 존재하고 활성 상태인지 확인
**403 금지 오류**
**증상**: 요청은 HTTP 403, 액세스 거부 메시지, 인증 실패를 반환합니다.
**일반적인 원인:**
+ MediaTailor에 필요한 쿼리 파라미터가 누락되었거나 잘못되었습니다.
+ CDN이 필수 헤더 또는 파라미터를 전달하지 않음
+ IP 주소 제한 또는 지리적 차단
+ 인증 토큰 문제(서명URLs을 사용하는 경우)
**솔루션:**
+ 모든 필수 쿼리 파라미터가 포함되고 전달되었는지 확인
+ CDN 구성에서 헤더 및 파라미터 전달 확인
+ IP 제한 및 지리적 설정 검토
+ 인증 토큰 및 서명 프로세스 검증
**400 잘못된 요청 오류**
**증상**: 요청에서 HTTP 400 반환, 잘못된 요청 오류, 파라미터 검증 실패
**일반적인 원인:**
+ 잘못된 쿼리 파라미터 또는 URL 인코딩 문제
+ 잘못된 파라미터 값 또는 형식
+ 특정 MediaTailor 기능에 필요한 파라미터 누락
+ URL 길이 제한 초과
**솔루션:**
+ 쿼리 파라미터 형식 및 URL 인코딩 검증
+ MediaTailor API 요구 사항과 비교하여 파라미터 값 확인
+ 모든 필수 파라미터가 포함되어 있는지 확인합니다.
+ URL 길이 검토 및 파라미터 최적화 고려
**5xx 서버 오류**
**증상**: 요청에서 HTTP 500, 502, 503 또는 504 오류, 간헐적인 서비스 장애 반환
**일반적인 원인:**
+ MediaTailor 서비스 문제 또는 용량 제한
+ CDN 오리진 연결 문제
+ 느린 오리진 응답으로 인한 제한 시간 문제
+ 임시 서비스 성능 저하
**솔루션:**
+ AWS 서비스 상태 대시보드에서 MediaTailor 서비스 상태 확인
+ CDN 오리진 연결 및 제한 시간 설정 확인
+ 지수 백오프를 사용하여 재시도 로직 구현
+ MediaTailor CloudWatch 지표의 서비스 상태 모니터링
+ 문제가 지속되면 AWS Support에 문의하세요.
1. 기준 성능 측정:
+ MediaTailor에 직접 매니페스트 요청 응답 시간 테스트(대상: <200ms)
+ 매니페스트 요청에 대한 CDN 응답 시간 측정(대상: 캐시 적중의 경우 <100ms)
+ 오리진과 CDN 모두에서 세그먼트 로드 시간 확인
1. CDN 성능 분석:
+ 콘텐츠 세그먼트의 캐시 적중률 확인(대상: 인기 콘텐츠의 경우 >80%)
+ 오리진 실드(또는 이에 상응하는 CDN 기능)가 오리진과 동일한 AWS 리전에서 활성화되고 구성되어 있는지 확인합니다. 이 기능에는 서로 다른 CDNs이 서로 다른 이름을 사용합니다.
+ CDN 엣지 로케이션 성능 및 지리적 분포 모니터링
**성능 벤치마크:**
+ 매니페스트 생성 응답 시간을 모니터링하고 기준 성능과 비교
+ CDN 캐시 적중이 오리진 요청보다 훨씬 빠름
+ ADS 응답 시간으로 인해 매니페스트 생성이 지연되어서는 안 됩니다.
**추가 문제 해결 리소스:**
+ 포괄적인 성능 최적화 전략은 섹션을 참조하세요. [CDN 및 MediaTailor 통합을 위한 성능 최적화 가이드](cdn-optimization.md)
+ 오리진 실드 구현 세부 정보는 섹션을 참조하세요. [Origin Shield 구현](cdn-advanced-optimization.md#origin-shield-optimization)
+ CDN 캐싱 최적화는 섹션을 참조하세요. [CDN 및 MediaTailor 통합을 위한 캐싱 최적화](cdn-optimize-caching.md)
+ 성능 모니터링 및 지표는 섹션을 참조하세요. [MediaTailor CDN 작업 및 성능 모니터링](cdn-monitoring.md)
+ 성능 테스트 절차는 섹션을 참조하세요. [CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md)
**성공 기준:** 해결되면 응답 시간은 대상 벤치마크(매니페스트 200ms 미만, 세그먼트 100ms 미만)를 충족해야 하고, 캐시 적중률은 대부분의 콘텐츠 유형에 대해 90%를 초과해야 하며, 오리진 요청 볼륨은 총 요청의 5% 미만이어야 합니다. 성능은 모든 지리적 리전 및 디바이스 유형에서 일관되어야 합니다.
# MediaTailor의 디바이스 및 플랫폼 간 CDN 불일치 동작 수정
AWS Elemental MediaTailor 콘텐츠 전송 네트워크(CDN) 통합은 모든 디바이스 및 플랫폼에서 일관된 광고 전송을 제공해야 합니다. 디바이스 간에 광고가 다르게 동작하는 경우:
1. 모든 CDN 동작에서 일관된 헤더 전달을 보장합니다.
+ User-Agent, X-Forwarded-For 및 사용자 지정 대상 지정 헤더가 일관되게 전달되는지 확인
+ 헤더 전달 규칙이 모든 관련 캐시 동작에 적용되는지 확인
1. 플레이어와 CDN 구성의 호환성을 확인합니다.
+ 여러 플레이어 유형(HLS.js, Video.js, 네이티브 플레이어)으로 테스트하여 플레이어별 문제 식별
+ 플레이어별 헤더 요구 사항 또는 URL 처리 차이점 확인
1. 여러 디바이스 유형으로 테스트하여 디바이스별 문제를 식별합니다.
+ 테스트에 모바일 디바이스, 태블릿, 스마트 TVs 및 데스크톱 브라우저 포함
+ 다양한 운영 체제 및 브라우저 버전 테스트
+ 디바이스별 광고 타겟팅이 올바르게 작동하는지 확인
이러한 문제 해결 단계를 따랐지만 여전히 도움이 필요한 경우 섹션을 참조하세요[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)