MediaPackage, CDN 및 MediaTailor 통합 문제 해결

AWS Elemental MediaTailor AWS Elemental MediaPackage 및 콘텐츠 전송 네트워크(CDN)와 통합하면 재생, 캐싱 또는 기타 통합 기능에 영향을 미치는 일반적인 문제가 발생할 수 있습니다. 재생 문제, 캐싱 문제 또는 기타 통합 관련 오류가 발생할 때이 가이드를 사용합니다.

모든 MediaTailor 구현에 적용되는 범용 캐시 성능 문제, HTTP 오류 해결, 테스트 절차 및 진단 기술을 포함한 포괄적인 CDN 문제 해결 지침은 섹션을 참조하세요CDN 통합 문제 해결. 이 섹션에서는 MediaPackage 관련 문제 해결 요구 사항에 중점을 둡니다.

문제를 해결하기 전에 기본 통합 설정을 올바르게 완료했는지 확인합니다. 아직 통합을 설정하지 않았거나 설정 단계를 검토해야 하는 경우 섹션을 참조하세요MediaTailor를 MediaPackage 및 CDN과 통합 . 문제 해결 후 캐시 성능 최적화에 대한 지침은 섹션을 참조하세요CDN 캐싱.

매니페스트 필터링 오류

문서화된 오류 조건에 따른 MediaPackage 매니페스트 필터링 기능 관련 문제:

매니페스트 필터링과 관련된 HTTP 400 오류

증상: aws.manifestfilter 파라미터가 있는 요청은 HTTP 400 잘못된 요청을 반환합니다.

검증된 원인(설명서에서 AWS ):

• 필터 기준은 빈 매니페스트를 생성합니다(필터 조건과 일치하는 스트림 없음).

• 잘못된 필터 파라미터 이름 또는 값

• 형식이 잘못된 쿼리 문자열 구문

• 중복 또는 반복 필터 파라미터

• 필터 파라미터 문자열이 1,024자를 초과함

• 미디어 재생 목록 또는 세그먼트에 적용된 쿼리 파라미터(지원되지 않음)

솔루션:

1. 필터 파라미터를 검토하여 사용 가능한 콘텐츠 스트림과 일치하는지 확인합니다. 필터링으로 일치하는 스트림이 없는 경우 MediaPackage는 HTTP 400을 반환합니다.

2. 지원되는 파라미터 이름 및 값 형식과 비교하여 필터 구문을 검증합니다.

3. 쿼리 문자열에 중복 파라미터가 있는지 확인합니다.

4. 필터 파라미터가 미디어 재생 목록 또는 세그먼트가 아닌 다변량 재생 목록에만 적용되는지 확인합니다.

5. 총 파라미터 문자열이 1024자 미만인지 확인합니다.

참조: AWS Elemental MediaPackage 매니페스트 필터링 오류 조건

매니페스트 필터링이 작동하지 않음(HTTP 200이지만 필터링이 적용되지 않음)

증상: 요청은 HTTP 200을 반환하지만 매니페스트에는 필터링된 하위 집합 대신 모든 스트림이 포함됩니다.

가능한 원인:

• MediaPackage에 aws.manifestfilter 쿼리 파라미터를 전달하지 않는 CDN

• 사용 가능한 스트림에서 필터 파라미터를 찾을 수 없음(HTTP 200으로 필터링되지 않은 매니페스트 반환)

솔루션:

1. CDN 캐시 정책이 전달된 쿼리 문자열 목록에 aws.manifestfilter를 포함하는지 확인합니다.

2. MediaPackage 엔드포인트(CDN 우회)에 대해 직접 필터 파라미터를 테스트하여 예상대로 작동하는지 확인합니다.

3. 필터 값이 콘텐츠 스트림의 실제 특성과 일치하는지 확인합니다.

참조: AWS Elemental MediaPackage 매니페스트 필터링 오류 조건

진단 절차

체계적인 진단 절차를 통해 통합 문제의 근본 원인을 빠르고 효율적으로 식별할 수 있습니다. 구조화된 접근 방식을 따르면 잘못된 가정으로 인한 시간 낭비를 방지하고 증상보다는 실제 문제를 해결할 수 있습니다. 이러한 증거 기반 진단 단계는 문제를 격리하고 적절한 솔루션으로 안내하도록 설계되었습니다.

다음 증거 기반 진단 단계에 따라 문제를 식별합니다.

캐시 성능 분석

캐시 성능 분석은 EMP 통합에 매우 중요합니다. 캐시 효율성이 좋지 않으면 오리진 로드가 증가하고 비용이 증가하며 재생 문제가 발생할 수 있기 때문입니다.

캐시 적중률 분석, 캐시 키 최적화 및 체계적인 진단 단계를 포함한 포괄적인 캐시 성능 문제 해결은 기본 CDN 문제 해결 안내서CDN 캐시 성능 문제의 섹션을 참조하세요.

EMP별 캐시 고려 사항:

• EMP 캐시 제어 헤더: CDN이 EMP의 캐시 제어 헤더를 재정의하지 않고 준수하는지 확인합니다.

• EMP 쿼리 파라미터: 필요한 EMP 쿼리 파라미터만 캐시 키에 포함되는지 확인합니다.

• EMP TTL 동작: 다양한 EMP 콘텐츠 유형에 적절한 캐시 기간이 있는지 확인

EMP 캐시 정책 및 TTL 설정 최적화에 대한 자세한 지침은 섹션을 참조하세요MediaTailor 및 MediaPackage 콘텐츠 전송을 위한 CDN 캐싱 최적화.

매니페스트 필터링 구성 검증

매니페스트 필터링 검증은 필터링 문제로 인해 최종 사용자가 잘못된 콘텐츠, 지원되지 않는 형식 또는 액세스해서는 안 되는 콘텐츠를 수신할 수 있기 때문에 필수적입니다. 체계적 테스트는 문제가 CDN 구성, 필터 파라미터 구문 또는 콘텐츠 가용성과 관련이 있는지 식별하는 데 도움이 됩니다.

매니페스트 필터링 기능을 체계적으로 테스트합니다.

1. MediaPackage 엔드포인트(CDN 우회)에 대해 직접 필터 파라미터를 테스트하여 올바르게 작동하는지 확인합니다.

2. 필터링된 매니페스트와 필터링되지 않은 매니페스트를 비교하여 예상 스트림이 포함/제외되었는지 확인합니다.

3. CDN 캐시 정책이 aws.manifestfilter 쿼리 파라미터를 전달하는지 확인합니다.

4. HTTP 400 오류를 확인하고 문서화된 오류 조건과 일치시킵니다.

문제 해결 후 매니페스트 필터링을 구현하거나 수정해야 하는 경우 전체 설정 지침은 섹션을 참조MediaTailor, MediaPackage 및 CDN을 사용하여 매니페스트 필터링 설정하세요.

쿼리 파라미터 구성 검증

CDN이 필요한 쿼리 파라미터만 전달하는지 확인합니다.

1. CDN 캐시 정책을 검토하여 AWS 권장 파라미터만 포함하는지 확인합니다.

   • aws.manifestfilter - 매니페스트 필터링용

   • aws.manifestsettings - 시간 이동 보기

   • _HLS_msn 및 _HLS_part - LL-HLS 지원용

2. MediaPackage는 쿼리 파라미터를 무시하고 캐시 효율성을 줄이므로 캐시 키에서 다른 쿼리 파라미터를 제거합니다.

참조: AWS Elemental MediaPackage 및 CDNs 작업

오류 코드 참조

문서화된 오류 조건 및 원인에 대한 참조:

HTTP 400 잘못된 요청(매니페스트 필터링)

문서화된 원인:

• 필터를 적용하면 빈 매니페스트가 생성됩니다.

• 잘못된 파라미터 이름 또는 값

• 형식이 잘못된 쿼리 문자열 구문

• 중복 필터 파라미터

• 파라미터 문자열이 1024자를 초과함

• 미디어 재생 목록 또는 세그먼트의 쿼리 파라미터

참조: MediaPackage 매니페스트 필터링 오류 조건

HTTP 200 OK(필터링이 적용되지 않음)

문서화된 원인:

• 사용 가능한 스트림에서 필터 파라미터를 찾을 수 없음(필터링되지 않은 매니페스트 반환)

• 필터링 후 존재하는 자막 스트림만(필터링되지 않은 매니페스트 반환)

참조: MediaPackage 매니페스트 필터링 오류 조건

추가 문제 해결 리소스

이 주제에서 다루지 않은 문제는 다음 공식 AWS 리소스를 참조하세요.

• 에서 매니페스트 미리 보기 AWS Elemental MediaPackage - 매니페스트 미리 보기를 사용하여 콘텐츠 패키징 문제 해결

• CloudFront 캐시 적중률 증가 - CDN 캐시 최적화에 대한 포괄적인 가이드

• 매니페스트 필터링 - MediaPackage 필터링 기능에 대한 전체 가이드