기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# MediaTailor를 MediaPackage 및 CDN과 통합
AWS Elemental MediaTailor 는와 통합되어 콘텐츠 전송 네트워크(CDN)를 통해 개인화된 비디오 광고를 AWS Elemental MediaPackage 제공합니다. MediaPackage는 인터넷을 통한 전송을 위해 비디오 콘텐츠를 준비하고 보호하는 just-in-time 비디오 패키징 및 제작 서비스입니다. 라이브 또는 온디맨드 비디오 콘텐츠를 가져와 HLS 및 DASH와 같은 스트리밍 형식으로 패키징하므로 다양한 디바이스에서 시청자가 사용할 수 있습니다.
MediaPackage를 MediaTailor 및 CDN과 결합하면 맞춤형 광고를 대규모로 제공하는 완전한 스트리밍 워크플로가 생성됩니다. CDN은 콘텐츠를 전 세계에 배포하여 지연 시간을 줄이고 시청자 경험을 개선하는 반면 MediaTailor는 대상 광고를 스트림에 삽입합니다.
이 주제에서는 MediaTailor, MediaPackage 및 CDN이 함께 작동하도록 하기 위한 필수 통합 단계에 중점을 둡니다. 고급 구성 옵션, 문제 해결 및 모니터링 지침은 섹션을 참조하세요[다음 단계](#emp-cdn-next-steps).
## MediaPackage 및 CDN 워크플로 이해
통합을 구성하기 전에 MediaPackage, MediaTailor 및 CDN이 어떻게 함께 작동하는지 이해하는 것이 중요합니다.
1. **콘텐츠 준비**: MediaPackage는 라이브 또는 온디맨드 비디오 콘텐츠를 수신하여 스트리밍 형식(HLS 또는 DASH 매니페스트 및 세그먼트)으로 패키징합니다.
1. **광고 삽입**: MediaTailor는 MediaPackage에서 매니페스트를 요청하고, 개인화된 광고를 삽입하며, 수정된 매니페스트를 최종 사용자에게 제공합니다.
1. **글로벌 배포**: CDN은 콘텐츠 세그먼트(MediaPackage)와 광고 세그먼트(MediaTailor)를 캐싱하고 전 세계 시청자에게 배포합니다.
1. **뷰어 재생**: 비디오 플레이어 요청 매니페스트는 MediaTailor(매니페스트의 경우)와 MediaPackage(콘텐츠 세그먼트의 경우) 간에 요청을 적절하게 라우팅하는 CDN을 통해 매니페스트됩니다.
이 아키텍처는 다음과 같은 몇 가지 이점을 제공합니다.
+ **확장성**: CDN은 오리진 서버에 영향을 주지 않고 높은 최종 사용자 로드를 처리합니다.
+ **성능**: 시청자와 가장 가까운 엣지 로케이션에서 콘텐츠가 전달됩니다.
+ **비용 효율성**: 캐싱을 통한 대역폭 비용 절감
+ **신뢰성**: 여러 엣지 로케이션이 중복성을 제공합니다.
## 사전 조건
시작하기 전에 다음 구성 요소가 구성되어 있는지 확인합니다.
1. **MediaPackage 엔드포인트**: 비디오 콘텐츠를 수신하고 패키징하는 구성된 MediaPackage 엔드포인트입니다. 설정 지침은 [ MediaPackage 사용 설명서의 MediaPackage 시작하기](https://docs.aws.amazon.com/mediapackage/latest/ug/getting-started.html)를 참조하세요. MediaPackage
1. **MediaTailor 구성**: MediaPackage 엔드포인트를 콘텐츠 오리진으로 사용하는 MediaTailor 구성입니다. 설정 지침은 단원을 참조하십시오[MediaTailor 광고 삽입을 위한 콘텐츠 소스 통합](integrating-origin.md).
1. **CDN 배포**: 스트리밍 미디어와 함께 작동하도록 구성된 CDN 배포(예: CloudFront)입니다. 설정 지침은 CloudFront 개발자 안내서의 [배포 생성을](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) 참조하세요.
1. **광고 결정 서버**: 광고 삽입을 위해 VAST 또는 VMAP 응답을 반환하는 구성된 광고 결정 서버입니다.
## 1단계: 필수 CDN 설정 구성
MediaPackage 통합을 성공적으로 수행하려면 적절한 CDN 구성이 중요합니다. 설정이 잘못되면 재생 실패, 캐시 성능 저하 및 비용 증가가 발생할 수 있습니다. 올바른 캐시 정책 및 쿼리 파라미터 전달이 없으면 CDN이 매니페스트를 올바르게 전달하지 못하거나 캐싱을 완전히 우회하여 오리진 서버 로드가 높아지고 최종 사용자 경험이 저하될 수 있습니다.
### 기본 캐시 설정 구성
MediaPackage는 특정 캐시 제어 헤더를 사용하여 콘텐츠 전송을 최적화하므로 기본 캐싱을 구성하는 것이 중요합니다. 적절한 캐시 설정이 없으면 CDN이 이러한 헤더를 무시하여 불필요한 오리진 요청과 지연 시간 증가로 이어질 수 있습니다. 최적의 캐싱 동작을 보장하려면 다음 단계를 따르세요.
MediaPackage에서 작동하는 기본 캐싱을 구성하려면:
1. CloudFront 콘솔에서 CloudFront 배포 설정을 엽니다.
1. MediaPackage 오리진에 대한 캐시 정책을 선택하거나 생성합니다.
1. "원본 캐시 제어 헤더" 옵션을 활성화합니다.
1. MediaPackage가 캐시 제어 헤더를 통해 캐싱 동작을 제어할 수 있도록 허용합니다.
이 기본 구성을 통해 MediaPackage는 다양한 콘텐츠 유형에 적합한 캐시 기간을 자동으로 설정할 수 있습니다. 특정 TTL 값 및 성능 튜닝으로 고급 캐시 최적화를 구현하려면 먼저이 기본 설정을 완료한 다음 로 계속 진행합니다[MediaTailor 및 MediaPackage 콘텐츠 전송을 위한 CDN 캐싱 최적화](cdn-emp-caching.md).
### 필수 쿼리 파라미터 구성
쿼리 파라미터 구성은 MediaPackage 기능에 매우 중요합니다. CDN은 특정 쿼리 파라미터를 전달하여 시간 이동 보기 및 짧은 지연 시간 스트리밍과 같은 기능을 활성화해야 합니다. 쿼리 파라미터 설정이 잘못되면 이러한 기능이 작동하지 않을 수 있으며 캐시 효율성이 저하될까 걱정됩니다. 다음 단계에 따라 쿼리 파라미터 전달을 구성합니다.
CDN이 필요한 쿼리 파라미터를 MediaPackage에 전달하도록 하려면:
1. CloudFront 배포 설정에서 매니페스트 요청에 대한 캐시 정책을 선택하거나 생성합니다.
1. "캐시 키 설정"에서 "지정된 쿼리 문자열 포함"을 선택합니다.
1. 다음과 같은 필수 쿼리 파라미터를 추가합니다.
+ `start` 및 `end` - 시간 이동 보기 기능의 경우. 이러한 파라미터는 MediaPackage로 전달되어 스타트오버 및 캐치업 보기를 위한 특정 콘텐츠 기간을 정의합니다.
+ `_HLS_msn` 및 `_HLS_part` - LL-HLS 재생 요청 지원
+ `m` - 엔드포인트의 수정된 ti/compame을 캡처하는 데 사용됩니다. MediaPackage 응답에는 항상 엔드포인트의 수정된 시간을 캡처하는 `?m=###` 태그가 포함됩니다. 콘텐츠가이 태그에 대해 다른 값으로 이미 캐시된 경우 CloudFront는 캐시된 버전을 제공하는 대신 새 매니페스트를 요청합니다.
+ `aws.manifestfilter` - 매니페스트 필터링 기능에 사용됩니다. 매니페스트 필터링을 사용하는 경우 매니페스트 필터링 기능이 작동하는 데 필요한 MediaPackage 오리진으로 `aws.manifestfilter` 쿼리 문자열을 전달하도록 배포를 구성하려면이 파라미터를 포함해야 합니다.
1. MediaPackage에서 사용하는 쿼리 문자열만 포함합니다. 불필요한 쿼리 문자열을 포함하면 동일한 콘텐츠에 대해 여러 캐시 변형을 생성하여 캐시 효율성이 떨어집니다.
이러한 파라미터를 사용하면 CDN에서 기본 MediaPackage 기능을 사용할 수 있습니다. 다양한 구독 계층 또는 디바이스 유형에 콘텐츠 필터링을 구현해야 하는 경우 먼저이 기본 쿼리 파라미터 설정을 완료한 다음 로 진행합니다[MediaTailor, MediaPackage 및 CDN을 사용하여 매니페스트 필터링 설정](cdn-emp-manifest-filtering.md).
MediaTailor가 시간 이동 보기를 위해 `start` 및를 `end` 통해 MediaPackage에 쿼리 파라미터를 전달하는 방법에 대한 자세한 내용은 [오리진에 대한 MediaTailor 쿼리 파라미터 처리](origin-query-parameters.md)의 섹션을 참조하세요[MediaTailor 매니페스트 쿼리 파라미터](manifest-query-parameters.md).
### LL-HLS에 대한 응답 제한 시간 구성
LL-HLS는 CDN이 새 콘텐츠 세그먼트를 기다리는 "차단 요청" 메커니즘을 사용하기 때문에 지연 시간이 짧은 HLS의 경우 제한 시간 구성이 중요합니다. 제한 시간이 너무 짧으면 MediaPackage가 새 세그먼트로 응답하기 전에 요청이 실패하여 재생이 중단되고 뷰어 경험이 저하됩니다. 원활한 LL-HLS 재생을 위해 적절한 제한 시간을 구성합니다.
지연 시간이 짧은 HLS를 사용하는 경우 CDN 제한 시간 설정을 구성합니다.
1. CDN 설정에서 오리진 제한 시간 구성을 찾습니다.
1. 응답 제한 시간 값을 파트 지속 시간의 3배 이상으로 설정합니다.
1. 예를 들어 파트 지속 시간이 0.3초인 경우 제한 시간을 0.9초 이상으로 설정합니다.
이렇게 하면 CDN이 요청 차단 메커니즘을 사용할 때 MediaPackage가 응답할 때까지 충분히 오래 기다릴 수 있습니다.
## 2단계: 통합 확인
통합 테스트는 최종 사용자에게 문제가 발생하기 전에 모든 구성 요소가 올바르게 함께 작동하는지 확인하는 데 필수적입니다. 통합에 실패하면 재생이 끊어지거나 광고가 누락되거나 성능이 저하될 수 있습니다. 이 확인 프로세스는 제어된 환경에서 문제를 식별하고 해결하는 데 도움이 됩니다.
CDN 설정을 구성한 후 콘텐츠 요청부터 광고 삽입까지 전체 워크플로를 테스트하여 통합이 올바르게 작동하는지 확인합니다.
### 2.1단계: 기본 재생 테스트
기본 재생 테스트는 CDN이 매니페스트 요청을 올바르게 처리하고 MediaTailor에 전달하는지 확인합니다. 이 테스트는 캐시 정책, 쿼리 파라미터 전달 및 매니페스트 처리와 관련된 구성 문제를 식별하는 데 도움이 됩니다. 다음 단계에 따라 기본 매니페스트 전송을 테스트합니다.
CDN을 통해 매니페스트를 요청하여 기본 통합이 작동하는지 테스트합니다.
1. 웹 브라우저 또는 curl을 사용하여 CDN을 통해 매니페스트 URL을 요청합니다.
1. 매니페스트가 성공적으로 로드되고 콘텐츠와 광고 세그먼트가 모두 포함되어 있는지 확인합니다.
1. 매니페스트의 콘텐츠 세그먼트 URLs CDN 도메인을 가리키는지 확인합니다.
1. 광고 세그먼트 URLs CDN 도메인도 가리키는지 확인합니다.
매니페스트가 올바르게 로드되고 예상 URLs이 포함된 경우 기본 통합이 작동하는 것입니다. 포괄적인 테스트 방법 및 고급 검증 절차는 섹션을 참조하세요[CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md). 통합의 성능 및 상태에 대한 포괄적인 모니터링을 설정하려면 섹션을 참조하세요[MediaPackage, CDN 및 MediaTailor 통합의 성능 모니터링](cdn-emp-monitoring.md).
### 2.2단계: 비디오 재생 테스트
비디오 재생 테스트를 통해 CDN을 통한 광고 삽입 및 콘텐츠 전송을 포함하여 완전한 통합이 end-to-end로 작동하도록 할 수 있습니다. 이 테스트는 콘텐츠 세그먼트와 광고 세그먼트가 모두 올바르게 캐싱 및 전달되고 최종 사용자 경험이 품질 표준을 충족하는지 확인합니다. 다음 단계에 따라 전체 재생 기능을 테스트합니다.
삽입된 광고에서 비디오 재생이 올바르게 작동하는지 테스트합니다.
1. 비디오 플레이어(예: Video.js 또는 HLS.js)를 사용하여 CDN을 통해 콘텐츠를 재생합니다.
1. 버퍼링 문제 없이 비디오가 원활하게 재생되는지 확인합니다.
1. 재생 중에 광고가 예상 시간에 삽입되었는지 확인합니다.
1. 콘텐츠와 광고 세그먼트가 모두 CDN(오리진에서 직접 로드되지 않음)에서 로드되는지 확인합니다.
광고에서 재생이 원활하게 작동하면 통합이 올바르게 작동하는 것입니다. 포괄적인 테스트 방법 및 고급 검증 절차는 섹션을 참조하세요[CDN 및 MediaTailor 통합 테스트 및 검증](cdn-integration-testing.md). 재생 문제, 버퍼링 또는 광고 삽입 문제가 발생하는 경우 섹션을 참조하세요[MediaPackage, CDN 및 MediaTailor 통합 문제 해결](cdn-emp-troubleshooting.md).
## 다음 단계
기본 통합을 완료한 후 고급 기능 및 최적화를 구현할 수 있습니다.
**고급 CDN 최적화**
자세한 캐시 최적화, TTL 구성 및 성능 튜닝은 섹션을 참조하세요[MediaTailor 및 MediaPackage 콘텐츠 전송을 위한 CDN 캐싱 최적화](cdn-emp-caching.md).
**매니페스트 필터링**
계층화된 서비스, 디바이스 최적화 또는 액세스 제어를 위한 콘텐츠 필터링을 구현하려면 섹션을 참조하세요[MediaTailor, MediaPackage 및 CDN을 사용하여 매니페스트 필터링 설정](cdn-emp-manifest-filtering.md).
**문제 해결**
통합에 문제가 발생하면 섹션을 참조하세요[MediaPackage, CDN 및 MediaTailor 통합 문제 해결](cdn-emp-troubleshooting.md).
**성능 모니터링**
포괄적인 모니터링을 설정하고 주요 성능 지표를 이해하려면 섹션을 참조하세요[MediaPackage, CDN 및 MediaTailor 통합의 성능 모니터링](cdn-emp-monitoring.md).
# MediaTailor, MediaPackage 및 CDN을 사용하여 매니페스트 필터링 설정
AWS Elemental MediaTailor 는와 함께 매니페스트 필터링 AWS Elemental MediaPackage 을 사용하여 콘텐츠 전송 네트워크(CDN)를 통해 여러 최종 사용자에게 전달되는 매니페스트에 포함되는 오디오 및 비디오 스트림을 사용자 지정합니다. 이는 계층형 서비스 상품, 디바이스별 최적화 또는 콘텐츠 액세스 제어를 구현하는 데 특히 유용합니다.
이 주제에서는 매니페스트 필터링 기능 구현에 특히 중점을 둡니다. 매니페스트 필터링을 구현하기 전에 기본 콘텐츠 전송 네트워크 통합 설정을 완료해야 합니다. 기본 MediaPackage 및 콘텐츠 전송 네트워크 통합을 아직 설정하지 않은 경우 로 시작합니다[MediaTailor를 MediaPackage 및 CDN과 통합](mediapackage-integration.md).
## 매니페스트 필터링 기능
매니페스트 필터링을 구현하기 전에이 기능으로 수행할 수 있는 작업을 이해합니다.
### 코어 필터링 기능
매니페스트 필터링은 콘텐츠 전송을 제어하는 데 도움이 되는 몇 가지 주요 기능을 제공합니다.
+ 프리미엄 콘텐츠(예: 4K HEVC)에 대한 최종 사용자 액세스 제한
+ 적절한 스트림을 사용하여 특정 디바이스 유형을 대상으로 지정
+ 오디오 샘플 속도, 언어 또는 비디오 코덱을 기반으로 콘텐츠 필터링
+ 다양한 구독자에게 다양한 품질 티어 제공
### 일반 사용 사례
이러한 사용 사례는 매니페스트 필터링이 특정 비즈니스 요구 사항을 해결하는 방법을 보여줍니다.
**구독 티어**
기본 구독자에게 해상도가 낮은 스트림을 제공하는 동시에 프리미엄 구독자에게 4K 콘텐츠에 대한 액세스 권한 제공
예: 기본 티어는 720p로 제한, 프리미엄 티어는 최대 4K까지 획득
**디바이스 최적화**
디바이스 기능에 따라 적절한 스트림을 자동으로 제공
예: 모바일 디바이스의 비트 전송률이 낮고 스마트 TVs 품질이 향상됩니다.
**대역폭 관리**
사용량이 가장 많은 기간 동안 스트림 품질을 제한하여 네트워크 비용 관리
예: 트래픽이 많은 이벤트 발생 시 최대 비트 전송률 감소
**리전별 콘텐츠**
최종 사용자 위치에 따라 다양한 오디오 언어 또는 콘텐츠 변형 제공
예: 로컬 언어 오디오 트랙 자동 필터링
매니페스트 필터링 개념에 대한 자세한 내용은 AWS Elemental MediaPackage 사용 설명서의 [매니페스트 필터링](https://docs.aws.amazon.com/mediapackage/latest/ug/manifest-filtering.html)을 참조하세요.
## 매니페스트 필터링을 위한 CDN 구성
CDN이 필터링이 작동하려면 MediaPackage에 `aws.manifestfilter` 쿼리 파라미터를 전달해야 하므로 매니페스트 필터링을 위한 CDN 구성이 필수적입니다. 적절한 쿼리 문자열 전달이 없으면 CDN에서 필터 파라미터를 제거하고 모든 뷰어는 구독 계층 또는 디바이스 기능에 관계없이 필터링되지 않은 매니페스트를 수신합니다. 이 구성을 사용하면 필터링 로직이 의도한 대로 MediaPackage 및 함수에 도달합니다.
CDN을 통해 매니페스트 필터링을 활성화하려면 쿼리 문자열 전달을 구성해야 합니다.
1. CloudFront 배포에서 매니페스트 요청에 대한 캐시 동작을 생성하거나 편집합니다.
1. **캐시 정책의** 경우 새 정책을 생성하거나 기존 정책을 편집합니다.
1. **캐시 키 설정**에서 "지정된 쿼리 문자열 포함"을 선택합니다.
1. `aws.manifestfilter`를 허용된 쿼리 문자열 목록에 추가합니다.
1. 다른 MediaPackage 기능도 사용하는 경우 쿼리 파라미터를 추가합니다.
+ `start` 및 `end` - 시간 이동 보기
+ `time_delay` - 시간 지연 기능의 경우
+ `_HLS_msn` 및 `_HLS_part` - LL-HLS의 경우
배포 생성에 대한 자세한 내용은 Amazon CloudFront 개발자 안내서의 [배포 생성을](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) 참조하세요.
## 클라이언트 측 필터링 구현
클라이언트 측 구현에서는 비디오 플레이어와 애플리케이션이 필터링된 콘텐츠를 요청하는 방법을 정의합니다. 이 구성은 각 최종 사용자가 구독 수준, 디바이스 기능 또는 기타 기준에 따라 수신하는 콘텐츠를 결정합니다. 적절한 구현을 통해 최종 사용자는 최적의 CDN 캐시 효율성을 유지하면서 액세스해야 하는 콘텐츠만 수신할 수 있습니다.
비디오 플레이어 및 애플리케이션에서 매니페스트 필터링을 구현하려면:
### 필터링 작동 방식
필터링 프로세스는 다음과 같이 작동합니다.
1. 비디오 플레이어 또는 애플리케이션이 필터 파라미터가 포함된 매니페스트 URL을 요청합니다.
1. CDN은 요청(쿼리 파라미터 포함)을 MediaTailor에 전달합니다.
1. MediaTailor는 오리진 매니페스트를 요청할 때 필터 파라미터를 MediaPackage에 전달합니다.
1. MediaPackage는 필터를 적용하고 기준과 일치하는 변형만 포함하는 사용자 지정 매니페스트를 반환합니다.
1. MediaTailor는 광고 삽입을 위해 필터링된 매니페스트를 처리하고 플레이어에게 반환합니다.
### 필터링을 위한 URL 형식
올바른 URL 형식을 이해하는 것은 성공적인 필터링 구현에 매우 중요합니다. URL 형식이 잘못되면 필터링 파라미터가 무시되거나 HTTP 오류가 발생합니다. URL 구조에는 CDN이 MediaPackage에 전달하는 쿼리 문자열로 필터 파라미터가 포함되어야 합니다. 다음 단계에 따라 적절한 URL 형식을 구현합니다.
비디오 플레이어에서 매니페스트 필터링을 구현하려면:
1. 적절한 필터 파라미터를 포함하도록 플레이어의 매니페스트 요청 URLs을 수정합니다.
1. 쿼리 파라미터와 함께 다음 URL 형식을 사용합니다.
```
https://CloudFront-Domain/v1/master/MediaTailor-Config/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US
```
1. 플레이어가이 URL을 요청하면 MediaTailor는 이러한 파라미터를 MediaPackage에 전달하여 필터링된 매니페스트를 생성합니다.
## 일반적인 필터링 시나리오
다음 예제를 사용하여 일반적인 필터링 시나리오를 구현합니다.
**디바이스별 콘텐츠 전송**
디바이스 기능을 기준으로 필터링하려면 매니페스트 요청에이 파라미터를 추가합니다.
```
aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100
```
이 예제에서는 모바일 디바이스에 적합한 최대 44.1kHz의 샘플 속도로 H.264 비디오 및 오디오로 콘텐츠를 제한합니다.
**프리미엄 콘텐츠 제한**
비트 전송률이 높은 콘텐츠에 대한 액세스를 제한하려면 매니페스트 요청에이 파라미터를 추가합니다.
```
aws.manifestfilter=video_bitrate:0-9000000
```
이 예제에서는 기본 구독 계층에 적합한 비디오 비트레이트를 9Mbps 이하로 제한합니다.
**언어 선택**
특정 오디오 언어를 필터링하려면 매니페스트 요청에이 파라미터를 추가합니다.
```
aws.manifestfilter=audio_language:fr,en-US,de
```
이 예제에는 프랑스어, 미국 영어 및 독일어 오디오 트랙만 포함됩니다.
**해결 대상 지정**
특정 비디오 해상도를 필터링하려면 매니페스트 요청에이 파라미터를 추가합니다.
```
aws.manifestfilter=video_height:240-360,720-1080
```
이 예제에는 중간 해상도를 제외하고 높이가 240\$1360픽셀\$1720-1080픽셀인 비디오 스트림이 포함되어 있습니다.
**코덱 기반 필터링**
특정 비디오 코덱을 필터링하려면 매니페스트 요청에이 파라미터를 추가합니다.
```
aws.manifestfilter=video_codec:h264,h265
```
이 예제에는 다른 코덱을 제외한 H.264 및 H.265 비디오 스트림만 포함됩니다.
## 특별 고려 사항 및 제한 사항
매니페스트 필터링을 구현할 때 발생하는 일반적인 문제를 방지하려면:
### 기술적 제한 사항
+ TS 매니페스트의 경우 오디오 변환 그룹을 사용하여 필터링된 오디오 스트림과 멀티플렉싱된 비디오 스트림을 제거하지 않도록 합니다.
+ TS 및 CMAF 매니페스트에서는 확인을 위해 오디오 샘플 속도와 비디오 비트레이트를 매니페스트에 쉽게 볼 수 없습니다.
+ 미디어 재생 목록 또는 세그먼트에 요청 파라미터를 추가하면 HTTP 400 오류가 발생합니다.
### 오류 조건
+ 필터링으로 인해 빈 매니페스트가 발생하는 경우(필터 기준을 충족하는 스트림 없음) MediaPackage는 HTTP 400 오류를 반환합니다.
+ 필터 구성(엔드포인트 필터 \$1 쿼리 파라미터)이 충돌하면 HTTP 404 오류가 발생합니다.
+ 잘못된 필터 구문 또는 지원되지 않는 필터 유형으로 인해 HTTP 400 오류가 발생합니다.
### 성능 고려 사항
+ 각 고유 필터 조합은 별도의 캐시 항목을 생성하여 캐시 효율성을 잠재적으로 줄일 수 있습니다.
+ 기준이 많은 복잡한 필터는 매니페스트 생성 성능에 영향을 미칠 수 있습니다.
+ 정적 필터링 시나리오에 엔드포인트 수준 필터를 사용하여 캐시 성능을 개선하는 것이 좋습니다.
## 필터링 구현 테스트
매니페스트 필터링 구현을 테스트하는 것은 최종 사용자가 액세스 수준 및 디바이스 기능에 따라 올바른 콘텐츠를 수신하도록 하는 데 매우 중요합니다. 필터링이 실패하면 최종 사용자가 잘못된 품질 수준, 지원되지 않는 형식 또는 액세스할 수 없는 콘텐츠를 수신할 수 있습니다. 포괄적인 테스트를 통해 이러한 문제가 최종 사용자에게 영향을 미치기 전에 식별하고 해결할 수 있습니다.
매니페스트 필터링이 올바르게 작동하는지 확인하려면:
1. 필터 파라미터가 다른 매니페스트를 요청하고 결과를 확인합니다.
1. 필터링된 매니페스트에 예상 스트림만 포함되어 있는지 확인
1. 엣지 케이스(빈 결과, 잘못된 필터)를 테스트하여 적절한 오류 처리를 보장합니다.
1. CDN이 필터 파라미터를 올바르게 전달하고 있는지 확인
1. 서로 다른 디바이스 및 플레이어로 테스트하여 호환성 보장
필터링 문제 해결은 * MediaPackage CDN 통합 문제 해결을* 참조하세요.
HTTP 400 오류, 빈 매니페스트 또는 예상대로 작동하지 않는 필터링 파라미터가 발생하는 경우 특정 매니페스트 필터링 문제 해결 지침은 [MediaPackage, CDN 및 MediaTailor 통합 문제 해결](cdn-emp-troubleshooting.md) 섹션을 참조하세요.
# MediaTailor 및 MediaPackage 콘텐츠 전송을 위한 CDN 캐싱 최적화
AWS Elemental MediaTailor 를 콘텐츠 오리진 AWS Elemental MediaPackage 으로 사용할 때 최적의 성능을 얻으려면 적절한 콘텐츠 전송 네트워크(CDN) 캐싱 구성이 필요합니다. MediaPackage는 콘텐츠 전송 네트워크에 다양한 유형의 콘텐츠를 캐싱할 기간을 알려주는 특정 캐시 제어 헤더를 제공합니다. 이러한 권장 사항을 따르면 원활한 재생과 효율적인 콘텐츠 전송이 가능합니다.
이 주제에서는 특히 캐싱 동작을 최적화하여 성능을 극대화하고 비용을 최소화하는 데 중점을 둡니다. 고급 캐싱 최적화를 구현하기 전에 기본 콘텐츠 전송 네트워크 통합 설정을 완료했는지 확인합니다. 아직 기본 통합을 설정하지 않은 경우 로 시작합니다[MediaTailor를 MediaPackage 및 CDN과 통합](mediapackage-integration.md).
## MediaPackage 캐시 제어 헤더
MediaPackage는 캐싱 동작을 최적화하기 위해 다양한 콘텐츠 유형에 대해 특정 TTL 값을 설정합니다.
**다변량 재생 목록(HLS 및 LL-HLS)**
TTL: 미디어 세그먼트 지속 시간의 절반
이유: 이러한 재생 목록은 새 세그먼트를 사용할 수 있게 되면 변경되므로 자주 업데이트해야 합니다.
**미디어 재생 목록(일반 HLS)**
TTL: 미디어 세그먼트 지속 시간의 절반
이유: 다변량 재생 목록과 마찬가지로 콘텐츠가 진행됨에 따라 이러한 업데이트
**미디어 재생 목록(LL-HLS)**
TTL: 1초
이유: 지연 시간이 짧은 스트리밍에는 매우 빈번한 업데이트가 필요합니다.
**TS 미디어 세그먼트 및 초기화 세그먼트**
TTL: 1209600초(14일)
이유: 미디어 세그먼트는 일단 생성되면 변경되지 않으므로 장기간 캐시할 수 있습니다.
**CMAF 미디어 세그먼트 및 초기화 세그먼트**
TTL: 1209600초(14일)
이유: TS 세그먼트와 마찬가지로 생성된 후에는 변경할 수 없습니다.
모든 MediaTailor 워크플로에 대한 포괄적인 TTL 권장 사항 및 추가 캐싱 최적화 전략은 섹션을 참조하세요[CDN 및 MediaTailor 통합을 위한 캐싱 최적화](cdn-optimize-caching.md).
## CDN 캐시 정책 구성
최적의 성능과 비용 효율성을 위해서는 적절한 캐시 정책 구성이 필수적입니다. 콘텐츠 유형(매니페스트, 세그먼트, 초기화 파일)마다 캐싱 요구 사항이 다릅니다. 별도의 캐시 동작을 사용하면 각 콘텐츠 유형에 대한 캐싱을 최적화하여 캐시 적중률을 개선하고 오리진 로드를 줄일 수 있습니다. 적절한 캐시 정책이 없으면 불필요한 오리진 요청, 비용 증가 및 재생 성능 저하가 발생할 수 있습니다.
MediaPackage 캐시 제어 헤더를 올바르게 적용하고 캐싱을 최적화하려면:
1. CloudFront 콘솔에서 CloudFront 배포 설정을 엽니다.
1. 다양한 콘텐츠 유형에 대해 별도의 캐시 동작을 생성합니다.
+ 매니페스트 요청(\$1.m3u8, \$1.mpd)
+ 미디어 세그먼트(\$1.ts, \$1.mp4, \$1.m4s)
+ 초기화 세그먼트
1. 각 캐시 동작에 대해 다음 설정을 사용하여 캐시 정책을 생성하거나 선택합니다.
+ "원본 캐시 제어 헤더" 옵션 활성화
+ "원본 요청 정책"을 설정하여 필요한 헤더 전달
+ 콘텐츠 유형에 따라 쿼리 문자열 전달 구성
### 매니페스트 캐시 동작
매니페스트 요청(\$1.m3u8, \$1.mpd)의 경우:
+ **경로 패턴**: \$1.m3u8 및 \$1.mpd
+ **캐시 정책**: 오리진 캐시 제어 헤더 명예
+ **쿼리 문자열**: 특정 파라미터 전달( 참조[쿼리 문자열 전달 최적화](#cdn-query-string-optimization))
+ **헤더**: 모든 헤더 전달(최소 요구 사항은 참조[MediaTailor CDN 통합에 필요한 헤더](cdn-configuration.md#cdn-required-headers))
### 미디어 세그먼트 캐시 동작
미디어 세그먼트(\$1.ts, \$1.mp4, \$1.m4s)의 경우:
+ **경로 패턴**: \$1.ts, \$1.mp4, \$1.m4s
+ **캐시 정책**: 오리진 캐시 제어 헤더 명예(14일 TTL)
+ **쿼리 문자열**: 없음(세그먼트는 쿼리 파라미터를 사용하지 않음)
+ **압축**: 전송 성능 향상
## 쿼리 문자열 전달 최적화
불필요한 쿼리 파라미터는 동일한 콘텐츠에 대해 여러 캐시 변형을 생성하므로 쿼리 문자열 최적화는 캐시 효율성에 매우 중요합니다. 각 고유 쿼리 파라미터 조합은 별도의 캐시 항목을 생성하여 캐시 적중률을 줄이고 오리진 요청을 증가시킵니다. MediaPackage에서 실제로 사용하는 쿼리 문자열만 전달하면 전체 기능을 유지하면서 캐시 효율성을 극대화할 수 있습니다.
MediaPackage가 사용하는 쿼리 문자열만 전달하도록 CDN을 구성하여 캐시 효율성을 개선합니다.
**필수 쿼리 문자열**
`start` 및 `end` - 시간 이동 보기 창의 경우
`time_delay` - 매니페스트 콘텐츠에 시간 지연 적용
`_HLS_msn`, `_HLS_m`및 `_HLS_part` - LL-HLS 재생 요청의 경우
**기능별 쿼리 문자열**
`aws.manifestfilter` - [매니페스트 필터링](cdn-emp-manifest-filtering.md)용
**중요**
캐시 키에 다른 쿼리 문자열을 포함하지 마십시오. MediaPackage는 인식할 수 없는 파라미터를 무시하며, 이를 포함하면 불필요한 캐시 변형을 생성하여 캐시 효율성이 줄어듭니다.
## 성능 최적화 기법
이러한 최적화는 MediaPackage 또는 MediaTailor가 아닌 CDN(예: CloudFront)에 구성됩니다. 캐시 성능을 극대화하기 위해 다음과 같은 추가 최적화를 구현합니다.
### 오리진 실드
오리진 실드는 CDN 엣지 로케이션과 MediaPackage 엔드포인트 간에 추가 캐싱 계층을 제공합니다. 이렇게 하면 MediaPackage 엔드포인트에 도달하는 요청 수가 줄어들어 특히 트래픽이 급증하거나 캐시 적중률이 최적보다 낮을 때 성능을 개선하고 비용을 절감할 수 있습니다. 오리진 실드는 여러 엣지 로케이션이 동일한 콘텐츠를 동시에 요청할 수 있는 라이브 스트리밍에 특히 유용합니다.
오리진 실드를 활성화하여 MediaPackage 엔드포인트의 부하를 줄입니다.
1. CloudFront 배포에서 MediaPackage 오리진에 대해 Origin Shield를 활성화합니다.
1. MediaPackage 엔드포인트와 가까운 오리진 실드 리전을 선택합니다.
1. 이렇게 하면 MediaPackage에 대한 요청을 줄이는 추가 캐싱 계층이 생성됩니다.
### 압축 구성
텍스트 기반 응답에 대해 압축을 활성화합니다.
+ 매니페스트 파일에 대한 압축 활성화(\$1.m3u8, \$1.mpd)
+ 미디어 세그먼트를 압축하지 마십시오(이미 압축됨).
+ 모든 헤더가 MediaPackage로 전달되는지 확인합니다(최소 요구 사항은 참조[MediaTailor CDN 통합에 필요한 헤더](cdn-configuration.md#cdn-required-headers)).
## 캐시 성능 모니터링
이러한 주요 지표를 추적하여 캐시 성능을 최적화합니다.
**캐시 적중률**
대상: 미디어 세그먼트의 경우 90%, 매니페스트의 경우 70% 이상
비율이 낮으면 잘못된 TTL 설정 또는 불필요한 쿼리 파라미터를 나타낼 수 있습니다.
**오리진 요청 볼륨**
MediaPackage 엔드포인트에 대한 요청 모니터링
대용량은 캐싱 문제를 나타낼 수 있습니다.
**캐시 키 변형**
캐시 키 패턴을 검토하여 불필요한 변형 식별
변형이 너무 많으면 캐시 효율성이 저하됩니다.
이러한 캐시 최적화를 구현한 후 효율성을 추적하도록 모니터링을 설정합니다. 캐시 적중률, 오리진 요청 패턴 및 기타 주요 성능 지표 모니터링에 대한 지침은 섹션을 참조하세요[MediaPackage, CDN 및 MediaTailor 통합의 성능 모니터링](cdn-emp-monitoring.md). 캐시 성능이 좋지 않거나 예기치 않은 오리진 요청이 관찰되는 경우 문제 해결 단계는 섹션을 참조[MediaPackage, CDN 및 MediaTailor 통합 문제 해결](cdn-emp-troubleshooting.md)하세요.
# MediaPackage, CDN 및 MediaTailor 통합의 성능 모니터링
AWS Elemental MediaTailor 에서는 및 콘텐츠 전송 네트워크(CDN) 통합의 최적의 성능을 유지하기 위해 효과적인 모니터링이 AWS Elemental MediaPackage 필요합니다. 이 주제에서는 추적할 주요 지표, 사용할 모니터링 도구, 사전 문제 감지에 대한 알림을 설정하는 방법에 대한 지침을 제공합니다.
모니터링을 설정하기 전에 기본 통합이 올바르게 작동하는지 확인합니다. 기본 콘텐츠 전송 네트워크 통합 설정을 완료하지 않은 경우 로 시작합니다[MediaTailor를 MediaPackage 및 CDN과 통합](mediapackage-integration.md). 모니터링을 통해 식별된 문제를 해결해야 하는 경우 섹션을 참조하세요[CDN 통합 문제 해결](cdn-emp-troubleshooting.md).
## 주요 성능 지표
이러한 필수 지표를 모니터링하여 MediaPackage 및 CDN 통합의 최적의 성능을 보장합니다.
### CDN 성능 지표
캐시 적중률 대상, 오리진 요청 볼륨 모니터링 및 응답 시간 벤치마크를 포함한 포괄적인 CDN 성능 지표는 CDN 최적화 가이드[CDN 및 MediaTailor 통합의 성능 벤치마크](cdn-performance-benchmarks.md)의 섹션을 참조하세요.
CDN 지표에 대한 주요 EMP별 고려 사항:
**EMP 캐시 제어 헤더**
**확인 사항**: CDN이 최적의 TTL 동작을 위해 EMP의 캐시 제어 헤더를 준수하는지 확인
**예상 동작**: EMP의 헤더에 따라 콘텐츠 유형에 따라 캐시 기간이 달라야 합니다.
EMP 캐시 최적화에 대한 자세한 지침은 섹션을 참조하세요[MediaTailor 및 MediaPackage 콘텐츠 전송을 위한 CDN 캐싱 최적화](cdn-emp-caching.md).
**쿼리 파라미터 영향**
**모니터링 대상**: EMP별 쿼리 파라미터가 캐시 효율성에 미치는 영향 추적
**최적화 대상**: 필요한 EMP 쿼리 파라미터만 캐시 키에 포함되는지 확인
**CDN 응답 시간**
**모니터링 대상**: 다양한 콘텐츠 유형(매니페스트 대 세그먼트)에 대한 응답 시간을 추적합니다.
**대상 값**:
+ 캐시된 콘텐츠: 100ms 미만
+ 오리진 요청: 500ms 미만
### MediaPackage 성능 지표
**오류 발생률**
**모니터링 대상**: CDN 및 MediaPackage 엔드포인트 모두에서 HTTP 오류율을 모니터링합니다. 구성 문제를 나타낼 수 있는 4xx 오류에 특히 주의하십시오.
**키 오류 코드**:
+ 400 오류: 매니페스트 필터링 문제와 관련된 경우가 많음
+ 404 오류: 라우팅 또는 구성 문제를 나타낼 수 있음
+ 504 오류: 제한 시간 문제, 특히 LL-HLS 관련 문제
**요청 볼륨 및 패턴**
**모니터링 대상**: MediaPackage 엔드포인트에 대한 요청 패턴을 추적하여 사용 추세 및 용량 요구 사항을 식별합니다.
**관찰할 패턴**:
+ 피크 사용 시간
+ 요청의 지리적 분포
+ 콘텐츠 유형 배포(라이브 vs. 온디맨드)
### 지연 시간 지표
**End-to-end 지연 시간**
**모니터링할 사항**: LL-HLS 구현의 경우 콘텐츠 수집부터 최종 사용자 재생까지의 end-to-end 지연 시간을 모니터링합니다. 지연 시간이 길면 CDN 구성 문제가 발생할 수 있습니다.
**대상 값**:
+ LL-HLS: 3초 미만의 glass-to-glass 지연 시간
+ 일반 HLS: 30초 미만
**매니페스트 생성 시간**
**모니터링할 사항**: 특히 필터링이 적용된 경우 MediaPackage에서 매니페스트를 생성하는 데 걸리는 시간입니다.
**대상 값**: 매니페스트 생성의 경우 200ms 미만
## 모니터링 도구 및 설정
포괄적인 모니터링 도구를 설정하는 것은 최적의 성능을 유지하고 최종 사용자에게 영향을 미치기 전에 문제를 신속하게 식별하는 데 필수적입니다. 적절한 모니터링이 없으면 최종 사용자가 재생 품질이 저하될 때까지 성능 저하, 캐시 비효율성 또는 통합 문제가 눈에 띄지 않을 수 있습니다. 올바른 모니터링 설정은 MediaPackage 및 CDN 통합의 모든 측면에 대한 가시성을 제공합니다.
다음 AWS 서비스 및 도구를 사용하여 MediaPackage 및 CDN 통합을 모니터링합니다.
### Amazon CloudWatch
Amazon CloudWatch는 두 서비스에서 지표를 수집하고 저장하여 MediaPackage 및 CDN 통합을 모니터링하는 기반을 제공합니다. 적절한 CloudWatch 구성을 사용하면 성능 추세를 식별하고, 문제를 해결하고, 통합을 최적화하는 데 필요한 데이터를 확보할 수 있습니다. CloudWatch 지표가 없으면 시스템 성능에 대한 가시성이 부족해지고 문제가 심각해질 때까지 감지되지 않을 수 있습니다.
포괄적인 지표 수집을 위한 CloudWatch 모니터링을 설정합니다.
1. **MediaPackage 지표**: MediaPackage 엔드포인트에 대한 CloudWatch 지표를 활성화하여 요청 볼륨, 오류율 및 응답 시간을 추적합니다.
1. **CDN 지표**: 캐시 적중률, 오리진 요청 수 및 오류율을 포함한 CloudFront 지표를 수집하도록 CloudWatch를 구성합니다.
1. **사용자 지정 지표**: 최종 사용자 참여 또는 콘텐츠 인기도와 같은 비즈니스별 KPIs에 대한 사용자 지정 지표를 생성합니다.
### CloudWatch 대시보드
포괄적인 대시보드를 생성하여 지표를 시각화합니다.
1. **개요 대시보드**: 전체 시스템 상태를 보여주는 상위 수준 지표
1. **CDN 성능 대시보드**: 캐시 성능 및 지리적 배포를 포함한 세부 CDN 지표
1. **MediaPackage 성능 대시보드**: 요청 패턴 및 오류율을 포함한 MediaPackage별 지표
1. **지연 시간 대시보드**: 다양한 콘텐츠 유형 및 리전에 대한 End-to-end 지연 시간 지표
### 로그 분석
자세한 문제 해결을 위해 로그 분석을 설정합니다.
1. **CDN 액세스 로그**: CDN 액세스 로그를 활성화 및 분석하여 요청 패턴을 이해하고 문제를 식별합니다.
1. **MediaPackage CloudWatch 로그**: 오류 및 성능 문제에 대한 MediaPackage 로그 모니터링
1. **로그 집계**: Amazon CloudWatch Logs Insights 또는 타사 도구를 사용하여 로그 패턴 분석
## 알림 및 알림 설정
알림 구성은 사전 문제 감지 및 해결에 매우 중요합니다. 적절한 알림이 없으면 최종 사용자 경험에 상당한 영향을 미치거나 서비스 중단을 일으킬 때까지 문제가 눈에 띄지 않을 수 있습니다. 잘 구성된 알림은 최종 사용자에게 영향을 미치기 전에 문제를 식별하고 해결하고 팀에 즉각적인 조치가 필요한 중요한 문제를 알리는 데 도움이 됩니다.
최종 사용자에게 영향을 미치기 전에 문제를 식별하도록 사전 예방 알림을 구성합니다.
### 중요 알림
중요한 문제에 대한 즉각적인 알림을 설정합니다.
+ **높은 오류율**: 5분 동안 4xx 또는 5xx 오류율이 5%를 초과하면 알림
+ **캐시 적중률 저하**: 캐시 적중률이 매니페스트의 경우 70%, 세그먼트의 경우 85% 미만으로 떨어질 때 알림
+ **높은 지연 시간**: end-to-end 지연 시간이 목표 임계값을 초과할 때 알림
+ **오리진 요청 급증**: 오리진 요청이 기준과 비교하여 50% 이상 증가할 때 알림
### 경고 알림
문제 발생을 나타낼 수 있는 추세에 대한 경고 알림을 설정합니다.
+ **점진적 성능 저하**: 30분 동안 응답 시간이 20% 증가할 때 알림
+ **캐시 효율성 추세**: 캐시 적중률이 시간 경과에 따른 감소 추세를 표시할 때 알림
+ **비정상적인 트래픽 패턴**: 요청 볼륨 또는 지리적 배포의 예기치 않은 변경에 대한 알림
## 최적화를 위해 모니터링 데이터 사용
모니터링 데이터를 활용하여 성능을 지속적으로 개선합니다.
### 정기적인 성능 검토
1. **주간 검토**: 주간 성능 추세 분석 및 최적화 기회 식별
1. **월별 용량 계획**: 트래픽 패턴을 사용하여 용량 요구 사항 및 CDN 최적화 계획
1. **분기별 아키텍처 검토**: 전반적인 아키텍처 효율성을 평가하고 개선이 필요한 영역을 식별합니다.
### 일반적인 최적화 작업
데이터 모니터링을 기반으로 다음 최적화 작업을 고려합니다.
+ **캐시 정책 조정**: 실제 콘텐츠 업데이트 패턴을 기반으로 TTL 값을 수정합니다. 자세한 TTL 최적화 지침은 섹션을 참조하세요[CDN 및 MediaTailor 통합을 위한 캐싱 최적화](cdn-optimize-caching.md).
+ **지리적 최적화**: 트래픽이 많은 리전에 CDN 엣지 로케이션 추가
+ **쿼리 파라미터 최적화**: 캐시를 조각화하는 불필요한 쿼리 파라미터 제거
+ **오리진 실드 구성**: 오리진 요청 볼륨이 많은 리전에서 오리진 실드 구현
MediaPackage와 관련된 자세한 모니터링 지침은 [ MediaPackage 사용 설명서의 MediaPackage 모니터링을](https://docs.aws.amazon.com/mediapackage/latest/ug/monitoring.html) 참조하세요. MediaPackage
# MediaPackage, CDN 및 MediaTailor 통합 문제 해결
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).
## 매니페스트 필터링 오류
문서화된 오류 조건에 따른 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)
## 진단 절차
체계적인 진단 절차를 통해 통합 문제의 근본 원인을 빠르고 효율적으로 식별할 수 있습니다. 구조화된 접근 방식을 따르면 잘못된 가정으로 인한 시간 낭비를 방지하고 증상보다는 실제 문제를 해결할 수 있습니다. 이러한 증거 기반 진단 단계는 문제를 격리하고 적절한 솔루션으로 안내하도록 설계되었습니다.
다음 증거 기반 진단 단계에 따라 문제를 식별합니다.
### 캐시 성능 분석
캐시 성능 분석은 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).
### 매니페스트 필터링 구성 검증
매니페스트 필터링 검증은 필터링 문제로 인해 최종 사용자가 잘못된 콘텐츠, 지원되지 않는 형식 또는 액세스해서는 안 되는 콘텐츠를 수신할 수 있기 때문에 필수적입니다. 체계적 테스트는 문제가 CDN 구성, 필터 파라미터 구문 또는 콘텐츠 가용성과 관련이 있는지 식별하는 데 도움이 됩니다.
매니페스트 필터링 기능을 체계적으로 테스트합니다.
1. MediaPackage 엔드포인트(CDN 우회)에 대해 직접 필터 파라미터를 테스트하여 올바르게 작동하는지 확인합니다.
1. 필터링된 매니페스트와 필터링되지 않은 매니페스트를 비교하여 예상 스트림이 포함/제외되었는지 확인합니다.
1. CDN 캐시 정책이 `aws.manifestfilter` 쿼리 파라미터를 전달하는지 확인합니다.
1. HTTP 400 오류를 확인하고 문서화된 오류 조건과 일치시킵니다.
문제 해결 후 매니페스트 필터링을 구현하거나 수정해야 하는 경우 전체 설정 지침은 섹션을 참조[MediaTailor, MediaPackage 및 CDN을 사용하여 매니페스트 필터링 설정](cdn-emp-manifest-filtering.md)하세요.
### 쿼리 파라미터 구성 검증
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)
## 오류 코드 참조
문서화된 오류 조건 및 원인에 대한 참조:
**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)
## 추가 문제 해결 리소스
이 주제에서 다루지 않은 문제는 다음 공식 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 필터링 기능에 대한 전체 가이드