CloudFront 및 MediaTailor 통합 모니터링 및 문제 해결 - AWS Elemental MediaTailor
통합에 대한 모니터링 설정MQAR 성능 모니터링일반적인 문제 해결워크플로 문제 해결다음 단계

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

CloudFront 및 MediaTailor 통합 모니터링 및 문제 해결

AWS Elemental MediaTailor Amazon CloudFront와 통합하려면 최적의 성능을 유지하기 위한 지속적인 모니터링 및 문제 해결이 필요합니다. CloudFront와 MediaTailor 통합을 구현한 후 성능을 모니터링하고 문제를 해결할 준비를 합니다. 콘텐츠 전송 네트워크(CDN)는 배포의 성능을 이해하고 잠재적 문제를 식별하는 데 도움이 되는 도구를 제공합니다.

통합에 대한 모니터링 설정

CloudFront 및 MediaTailor 통합의 성능을 추적하려면 다음 모니터링 전략을 구현합니다.

CloudFront 및 MediaTailor 통합에 대한 모니터링을 설정하려면

  1. CloudFront 표준 로깅 활성화:

    1. CloudFront 콘솔에서 배포를 선택합니다.

    2. 로그 탭을 선택합니다.

    3. 표준 로그에서 편집을 선택합니다.

    4. 켜기를 선택하고 로그 스토리지용 Amazon S3 버킷을 구성합니다.

    5. 변경 사항 저장을 선택합니다.

  2. CloudFront 실시간 로그 설정:

    1. CloudFront 콘솔에서 배포를 선택합니다.

    2. 로그 탭을 선택합니다.

    3. 실시간 로그에서 편집을 선택합니다.

    4. 켜기를 선택하고 Amazon Kinesis Data Streams 또는 Amazon Data Firehose 전송 스트림을 구성합니다.

    5. 로그 구성에 다음 필드를 포함합니다.

      • time-to-first-byte - 응답 시간

      • sc-status - HTTP 상태 코드

      • c-ip - 최종 사용자 IP 주소

      • cs-uri-stem - 요청 URI 경로

      • cs-user-agent - 사용자 에이전트

      • x-edge-result-type - 결과 유형(Hit, Miss, Error)

    6. 변경 사항 저장을 선택합니다.

  3. CloudWatch 대시보드 생성:

    1. CloudWatch 콘솔에서 대시보드를 선택합니다.

    2. 대시보드 생성(Create dashboard)을 선택합니다.

    3. 이러한 CloudFront 지표에 대한 위젯을 추가합니다.

      • 요청

      • BytesDownloaded

      • 4xxErrorRate

      • 5xxErrorRate

      • TotalErrorRate

      • CacheHitRate

  4. CloudWatch 경보 설정:

    1. CloudWatch 콘솔에서 경보를 선택합니다.

    2. 경보 생성(Create alarm)을 선택하세요.

    3. 다음 조건에 대한 경보를 생성합니다.

      • 5xxErrorRate > 5분 동안 1%

      • 5분 동안 4xxErrorRate가 5%보다 큼

      • 30분 동안 80% 미만의 CacheHitRate

MQAR 성능 모니터링

MQAR을 사용할 때 모니터링을 통해 CloudFront에서 오리진을 선택하는 방법과 품질 점수가 기대치를 충족하는지 여부를 이해할 수 있습니다. 실시간 로그에는 이러한 결정이 발생하는 즉시 표시됩니다.

MQAR 성능을 모니터링하려면

  1. CloudFront 배포에 대한 실시간 로그를 활성화합니다.

  2. 로그 구성에 다음 필드를 포함합니다.

    • r-host - 선택한 오리진의 호스트 이름

    • sr-reason - 오리진 선택 이유

    • x-edge-mqcs - 미디어 품질 신뢰도 점수

  3. Amazon Kinesis Data Streams 또는 Amazon Data Firehose에서 로그 대상을 설정합니다.

  4. 이러한 지표를 기반으로 대시보드 또는 알림을 생성하여 품질 점수 및 오리진 선택 결정을 모니터링합니다.

예 MQAR 모니터링을 위한 샘플 CloudWatch 대시보드

다음 지표를 사용하여 CloudWatch 대시보드를 생성합니다.

  • 리전별 오리진 선택 수

  • 시간 경과에 따른 평균 품질 점수

  • 장애 조치 이벤트

  • 오리진별 4xx 및 5xx 오류 발생률

실시간 로그 설정에 대한 자세한 내용은 CloudFront 개발자 안내서의 실시간 로그를 참조하세요.

일반적인 문제 해결

신중하게 계획하더라도 CloudFront 및 MediaTailor 통합에 문제가 발생할 수 있습니다. 일반적인 문제와 솔루션을 이해하면 문제를 신속하게 해결하고 최종 사용자에게 미치는 영향을 최소화할 수 있습니다.

CloudFront 및 MediaTailor 통합에 문제가 발생하면 다음과 같은 일반적인 문제와 해결 방법을 확인하세요.

매니페스트 캐싱 문제

증상: 오래된 매니페스트 또는 광고가 업데이트되지 않음

해결 방법: 다변량 재생 목록, 미디어 재생 목록 및 MPD 경로에 캐시 CachingDisabled 정책을 사용하고 있는지 확인합니다. 구성이 쿼리 파라미터를 올바르게 전달하는지 확인합니다.

CORS 오류

증상: 콘텐츠에 액세스할 때 브라우저 콘솔에 CORS 오류가 표시됨

해결 방법: 적절한 CORS 헤더로 응답 헤더 정책을 구성하고 캐시 동작과 연결합니다.

MQAR이 작동하지 않음

증상: 오리진 선택 시 품질 점수 무시

해결 방법: 오리진 그룹 설정에서 미디어 품질 점수 옵션을 활성화했는지 확인합니다. Lambda@Edge 오리진 방향 트리거를 사용하지 않는지 확인합니다.

광고 삽입 실패

증상: 광고가 제대로 삽입되지 않음

해결 방법: MediaTailor 구성이 콘텐츠 세그먼트 접두사에 대한 CloudFront 배포를 가리키는지 확인합니다. 설정이 필요한 모든 헤더를 전달하는지 확인합니다.

보다 복잡한 문제의 경우 다음과 같은 문제 해결 접근 방식을 사용할 수 있습니다.

  1. CloudFront 배포 로그에서 오류 패턴 확인

  2. 브라우저 개발자 도구를 사용하여 네트워크 요청 검사

  3. MediaTailor의 매니페스트 콘텐츠를 CloudFront를 통해 제공되는 콘텐츠와 직접 비교

  4. 세부 로깅을 지원하는 간단한 플레이어로 테스트

문제 해결에 대한 자세한 내용은 MediaTailor 사용 설명서의 문제 해결 섹션을 참조하세요.

워크플로 문제 해결

이 체계적인 접근 방식을 따라 CloudFront 및 MediaTailor 통합 관련 문제를 해결합니다.

CloudFront 및 MediaTailor 통합 문제를 해결하려면

  1. 특정 문제를 식별합니다.

    1. 문제가 모든 최종 사용자 또는 일부에만 영향을 미치는지 확인

    2. 영향을 받는 콘텐츠 유형 식별(매니페스트, 세그먼트 또는 둘 다)

    3. 오류 메시지 또는 증상 기록

  2. CloudFront 로그 확인:

    1. 오류 상태 코드(4xx 또는 5xx) 찾기

    2. 캐시 적중/누락 패턴 확인

    3. 요청이 올바른 오리진으로 라우팅되고 있는지 확인

  3. 구성 확인:

    1. 캐시 동작에서 올바른 경로 패턴 확인

    2. 캐시 정책이 올바르게 적용되었는지 확인

    3. 오리진 요청 정책이 필요한 헤더를 전달하는지 확인

  4. 직접 액세스 테스트:

    1. MediaTailor에서 직접 콘텐츠에 액세스해 보세요(CloudFront 우회).

    2. 직접 액세스와 CloudFront 액세스 간의 응답 비교

  5. 솔루션 구현:

    1. 조사 결과에 따라 적절한 수정 사항 적용

    2. 테스트하여 문제가 해결되었는지 확인

    3. 향후 참조를 위해 문제 및 솔루션 문서화

다음 단계

CloudFront 및 MediaTailor 통합에 대한 모니터링 및 문제 해결을 설정한 후 다음 단계를 고려하세요.