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

# MediaPackage, CDN 및 MediaTailor 통합 문제 해결
<a name="cdn-emp-troubleshooting"></a>

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

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

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

## 매니페스트 필터링 오류
<a name="manifest-filtering-errors"></a>

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

**매니페스트 필터링과 관련된 HTTP 400 오류**  
**증상**: `aws.manifestfilter` 파라미터가 있는 요청은 HTTP 400 잘못된 요청을 반환합니다.  
**검증된 원인(설명서에서 AWS ):**  
+ 필터 기준은 빈 매니페스트를 생성합니다(필터 조건과 일치하는 스트림 없음).
+ 잘못된 필터 파라미터 이름 또는 값
+ 형식이 잘못된 쿼리 문자열 구문
+ 중복 또는 반복 필터 파라미터
+ 필터 파라미터 문자열이 1,024자를 초과함
+ 미디어 재생 목록 또는 세그먼트에 적용된 쿼리 파라미터(지원되지 않음)
**솔루션:**  

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

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

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

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

1. 총 파라미터 문자열이 1024자 미만인지 확인합니다.
**참조**: [AWS Elemental MediaPackage 매니페스트 필터링 오류 조건](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

**매니페스트 필터링이 작동하지 않음(HTTP 200이지만 필터링이 적용되지 않음)**  
**증상**: 요청은 HTTP 200을 반환하지만 매니페스트에는 필터링된 하위 집합 대신 모든 스트림이 포함됩니다.  
**가능한 원인:**  
+ MediaPackage에 `aws.manifestfilter` 쿼리 파라미터를 전달하지 않는 CDN
+ 사용 가능한 스트림에서 필터 파라미터를 찾을 수 없음(HTTP 200으로 필터링되지 않은 매니페스트 반환)
**솔루션:**  

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

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

1. 필터 값이 콘텐츠 스트림의 실제 특성과 일치하는지 확인합니다.
**참조**: [AWS Elemental MediaPackage 매니페스트 필터링 오류 조건](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

## 진단 절차
<a name="validated-diagnostic-steps"></a>

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

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

### 캐시 성능 분석
<a name="cache-performance-analysis"></a>

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

캐시 적중률 분석, 캐시 키 최적화 및 체계적인 진단 단계를 포함한 포괄적인 캐시 성능 문제 해결은 기본 CDN 문제 해결 안내서[CDN 캐시 성능 문제](diagnose-performance-issues.md#cache-performance-troubleshooting)의 섹션을 참조하세요.

EMP별 캐시 고려 사항:
+ **EMP 캐시 제어 헤더**: CDN이 EMP의 캐시 제어 헤더를 재정의하지 않고 준수하는지 확인합니다.
+ **EMP 쿼리 파라미터**: 필요한 EMP 쿼리 파라미터만 캐시 키에 포함되는지 확인합니다.
+ **EMP TTL 동작**: 다양한 EMP 콘텐츠 유형에 적절한 캐시 기간이 있는지 확인

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

### 매니페스트 필터링 구성 검증
<a name="manifest-filtering-validation"></a>

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

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

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

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

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

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

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

### 쿼리 파라미터 구성 검증
<a name="query-parameter-validation"></a>

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

1. CDN 캐시 정책을 검토하여 AWS 권장 파라미터만 포함하는지 확인합니다.
   + `aws.manifestfilter` - 매니페스트 필터링용
   + `aws.manifestsettings` - 시간 이동 보기
   + `_HLS_msn` 및 `_HLS_part` - LL-HLS 지원용

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

**참조**: [AWS Elemental MediaPackage 및 CDNs 작업](https://docs.aws.amazon.com/mediapackage/latest/userguide/cdns.html)

## 오류 코드 참조
<a name="documented-error-reference"></a>

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

**HTTP 400 잘못된 요청(매니페스트 필터링)**  
**문서화된 원인**:  
+ 필터를 적용하면 빈 매니페스트가 생성됩니다.
+ 잘못된 파라미터 이름 또는 값
+ 형식이 잘못된 쿼리 문자열 구문
+ 중복 필터 파라미터
+ 파라미터 문자열이 1024자를 초과함
+ 미디어 재생 목록 또는 세그먼트의 쿼리 파라미터
**참조**: [MediaPackage 매니페스트 필터링 오류 조건](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

**HTTP 200 OK(필터링이 적용되지 않음)**  
**문서화된 원인**:  
+ 사용 가능한 스트림에서 필터 파라미터를 찾을 수 없음(필터링되지 않은 매니페스트 반환)
+ 필터링 후 존재하는 자막 스트림만(필터링되지 않은 매니페스트 반환)
**참조**: [MediaPackage 매니페스트 필터링 오류 조건](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

## 추가 문제 해결 리소스
<a name="additional-resources"></a>

이 주제에서 다루지 않은 문제는 다음 공식 AWS 리소스를 참조하세요.
+ [에서 매니페스트 미리 보기 AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/userguide/endpoints-preview.html) - 매니페스트 미리 보기를 사용하여 콘텐츠 패키징 문제 해결
+ [CloudFront 캐시 적중률 증가](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html) - CDN 캐시 최적화에 대한 포괄적인 가이드
+ [매니페스트 필터링](https://docs.aws.amazon.com/mediapackage/latest/userguide/manifest-filtering.html) - MediaPackage 필터링 기능에 대한 전체 가이드