MediaTailor 및 CDN 통합 관련 문제 해결 - AWS Elemental MediaTailor
문제 해결 준비워크플로별 문제 해결 가이드

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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 통합 로그 분석 참조

  • 에스컬레이션 및 추가 도움말은 섹션을 참조하세요. CDN 통합 지원 받기

문제 해결 준비

CDN 통합 문제가 발생할 때 문제 해결을 간소화하는 도구 및 프로세스를 설정합니다. 사전 대비를 통해 문제가 발생할 때 문제를 더 빠르고 효과적으로 해결할 수 있습니다.

포괄적인 로깅 활성화

CDN 통합 문제를 진단하려면 세부 로그가 필수적입니다. 문제 해결 중에 필요한 정보를 캡처하도록 로깅을 구성합니다.

  1. 세부 CDN 액세스 로그 활성화:

    • MediaTailor 요청을 처리하는 모든 캐시 동작에 대한 로깅 구성

    • 로그 항목에 쿼리 문자열 및 사용자 지정 헤더 포함

    • 패턴과 이상을 식별하기 위한 로그 분석 도구 설정

    • 실시간 이벤트 중 즉각적인 문제 감지를 위한 실시간 로그 활성화

    • 기록 문제 해결 데이터를 유지하도록 로그 보존 정책 구성

  2. MediaTailor 로깅 구성:

    • MediaTailor 구성에 대한 액세스 로그 활성화

    • 중앙 집중식 로그 관리를 위한 CloudWatch 로그 그룹 설정

    • 오류 패턴을 식별하도록 로그 필터 구성

  3. 오리진 서버 로깅 설정:

    • 콘텐츠 오리진 서버에서 세부 액세스 로그 활성화

    • 로그에 요청 헤더 및 응답 코드 포함

    • 오리진 서버 성능 지표 모니터링

진단 요청 헤더 추가

사용자 지정 헤더는 CDN을 통해 요청을 추적하고 라우팅 문제를 식별하는 데 도움이 됩니다.

  1. CDN 진단 헤더 구성:

    • 각 요청에 고유 식별자 추가(예: X-Request-ID)

    • 요청 헤더에 CDN 관련 정보 포함

    • 지리적 라우팅을 추적하기 위해 엣지 로케이션 또는 POP(존재 지점) 정보 추가

    • 캐시 동작 분석을 위한 캐시 상태 헤더(Hit, Miss, RefreshHit) 포함

  2. 디버깅을 위한 응답 헤더 추가:

    • 서버 식별 헤더 포함

    • 성능 분석을 위한 타이밍 정보 추가

    • 매니페스트 요청에 대한 캐시 제어 헤더 포함

기준 성능 지표 설정

정상 성능 범위를 문서화하여 문제 해결 중에 이상을 빠르게 식별합니다.

  1. 기준 지표를 기록합니다.

    • 다양한 콘텐츠 유형에 대한 캐시 적중률

    • 응답 시간 백분위수(P50, P95, P99)

    • 상태 코드별 오류 발생률

    • 시간대별 요청 볼륨 패턴

  2. 성능 기대치 문서화:

    • 대상 캐시 적중률(콘텐츠의 경우 95% 이상, 광고의 경우 90% 이상)

    • 허용 가능한 응답 시간(캐싱된 <100ms, 오리진 <500ms)

    • 허용되는 최대 오류율(4xx의 경우 <1%, 5xx의 경우 <0.1%)

  3. 성능 대시보드 생성: 기준 값과 비교하여 현재 지표를 표시하는 모니터링 대시보드를 설정합니다.

문제 해결 도구 준비

효과적인 문제 해결에 필요한 도구 및 액세스 권한을 설정합니다.

  1. 명령줄 도구:

    • curl HTTP 요청 및 응답 테스트용

    • dig DNS 문제 해결을 nslookup 위한 또는

    • 매니페스트 확인을 위한 HLS/DASH 검증 도구

    • 로그 분석 도구(grep, awk 또는 특수 로그 분석기)

  2. 액세스 권한:

    • 구성 검토를 위한 CDN 관리 콘솔 액세스

    • 구성 확인을 위한 MediaTailor 콘솔 액세스

    • 지표 및 로그 분석을 위한 CloudWatch 액세스

    • 백엔드 문제 해결을 위한 오리진 서버 액세스

  3. 설명서:

    • 네트워크 아키텍처 다이어그램

    • CDN 및 MediaTailor 구성 설명서

    • 에스컬레이션 절차를 위한 연락처 정보

    • 일반적인 시나리오에 대한 런북 문제 해결

워크플로별 문제 해결 가이드

이 범용 문제 해결 가이드에서는 모든 MediaTailor CDN 통합의 일반적인 문제를 다룹니다. 특정 워크플로 또는 서비스와 관련된 문제는 다음 특수 문제 해결 리소스를 참조하세요.

서버 측 광고 삽입(SSAI) 문제 해결

광고 삽입 실패, 광고 전환 문제 및 개인화 문제를 포함한 SSAI 관련 문제는 워크플로별 SSAI 문제 해결 설명서를 참조하세요.

일반적인 SSAI 관련 문제:

  • 광고 삽입 실패 및 빈 광고 중단

  • 광고 전환 타이밍 및 동기화 문제

  • 개인화 및 대상 지정 문제

  • 광고 추적 및 분석 불일치

채널 어셈블리 문제 해결

매니페스트 생성 문제 및 시간 전환 기능을 포함한 채널 어셈블리 관련 문제는 채널 어셈블리 워크플로 설명서를 참조하세요.

일반적인 채널 어셈블리 문제:

  • 매니페스트 생성 및 컴파일 오류

  • 시간 전환 기간 및 DVR 기능 문제

  • 소스 콘텐츠 가용성 및 장애 조치 문제

  • 프로그램 일정 및 메타데이터 동기화

MediaPackage 통합 문제 해결

매니페스트 필터링 및 EMP 엔드포인트 문제를 포함한 MediaPackage 관련 문제는 섹션을 참조하세요CDN 통합 문제 해결.

일반적인 MediaPackage 통합 문제:

  • 매니페스트 필터링 파라미터 오류

  • MediaPackage 엔드포인트 연결 문제

  • EMP별 캐시 동작 문제

  • MediaPackage 오리진 인증 문제

CloudFront 관련 문제 해결

CloudFront별 구성 및 설정 문제는 CloudFront 통합 설명서를 참조하세요.

일반적인 CloudFront 문제:

  • 배포 구성 및 캐시 동작 설정

  • 오리진 액세스 ID 및 보안 구성

  • CloudFront 관련 오류 코드 및 응답

  • 지리적 제한 및 엣지 로케이션 문제

추가 리소스: