기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
MediaTailor의 재생 구성에서 내보낸 로그에는 재생 세션 중에 발생하는 다양한 활동에 대한 정보가 포함됩니다. 이러한 활동은 로그의 이벤트 유형에서 식별됩니다. 기본적으로 많은 이벤트가 로깅됩니다. Amazon CloudWatch에서 로그 비용을 제어하는 데 도움이 되도록 MediaTailor에서 내보내는 로그를 지정할 수 있습니다.
MediaTailor는 로그 필터링을 제어하므로 다음을 수행할 수 있습니다.
-
로그에서 제외하려는 로그 이벤트 지정
-
광고 결정 서버(ADS)에서 원시 응답 로깅 활성화
이러한 로그 필터링 기본 설정을 각 재생 세션에 대해 독립적으로 설정하거나 재생 구성에 대한 모든 재생 세션의 기본값으로 설정할 수 있습니다.
-
세션별로 로그를 필터링하려면 재생 세션 초기화 요청에 쿼리 파라미터를 포함합니다.
-
재생별 구성을 기준으로 로그를 필터링하려면 MediaTailor 콘솔 또는 API를 사용하여 재생 구성 설정에서 기본 설정을 지정합니다.
다음 섹션에서는 세션 및 재생 구성에서 로그 필터링을 활성화하는 지침을 제공합니다.
각 세션에 대한 사용자 지정 로그 세부 정보 수준을 정의하려면 초기 서버 측 또는 클라이언트 측 재생 세션 요청에 다음 파라미터를 추가합니다. 파라미터에 값을 추가하여 포함하거나 제외하려는 이벤트를 쉼표로 구분된 형식으로 나타냅니다.
-
aws.adsInteractionLogPublishOptInEventTypes
특정 광고 결정 서버(ADS) 상호 작용에 대한 로그를 수신합니다. -
aws.adsInteractionLogExcludeEventTypes
- 특정 ADS 상호 작용에 대한 로그 수신을 중지합니다. -
aws.manifestServiceLogExcludeEventTypes
- 특정 매니페스트 서비스 상호 작용에 대한 로그 수신을 중지합니다.
MediaTailor에서 내보내는 로그 및 이벤트 유형 목록은 매니페스트 로그, ADS 로그및 단원을 참조하십시오로그 트랜스코딩.
로그 필터링을 위한 쿼리 파라미터를 전달하지 않으면 MediaTailor는 모든 로그를 전송 대상에 기록합니다.
예 로그 필터를 사용한 서버 측 세션 초기화
매니페스트 로그 및 ADS 로그MAKING_ADS_REQUEST
에서 GENERATED_MANIFEST
및 PARSING_ERROR
이벤트를 제외하려면 세션 초기화 요청은 다음과 같습니다.
GET <mediatailorURL>
/v1/master/<hashed-account-id>
/<origin-id>
/index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUEST
ADS에서 원시 로그를 활성화하려면 AdsInteractionPublishOptInEventType
파라미터 RAW_ADS_RESPONSE
값을 포함합니다.
GET <mediatailorURL>
/v1/master/<hashed-account-id>
/<origin-id>
/index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSE
예 로그 필터를 사용한 클라이언트 측 세션 초기화
클라이언트 측 세션 초기화 중에 로그 이벤트를 제외하려면 MediaTailor에 대한 클라이언트의 POST 요청에 availSuppression
및 로그 유형 파라미터를 포함합니다. 클라이언트 측 재생 세션 요청을 구성하는 방법에 대한 자세한 내용은 클라이언트 측 광고 추적 단원을 참조하십시오. 다음 예시에서는 매니페스트 로그 및 ADS 로그MAKING_ADS_REQUEST
에서 CONFIG_SECURITY_ERROR
및 PARSING_ERROR
이벤트를 제외합니다.
POST parent.m3u8
{
"adsInteractionLog": {
...
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
}
ADS에서 원시 로그를 활성화하려면 publishOptInEventTypes
파라미터 RAW_ADS_RESPONSE
값을 포함합니다.
POST parent.m3u8
{
"adsInteractionLog": {
"publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
}
재생 구성의 설정을 사용하여 MediaTailor가이 재생 구성에서 기본값으로 내보내는 로그 이벤트 유형을 정의합니다. MediaTailor는 세션 초기화 요청에 쿼리 파라미터 필터링을 포함하지 않는 모든 세션에 대해 이러한 기본 로그 필터링 설정을 사용합니다.
다음을 수행하도록 선택할 수 있습니다.
-
특정 광고 결정 서버(ADS) 상호 작용에 대한 로그를 수신합니다.
-
특정 ADS 상호 작용에 대한 로그를 제외합니다.
-
특정 매니페스트 서비스 상호 작용에 대한 로그를 제외합니다.
MediaTailor 콘솔에서 이러한 설정을 지정하려면 섹션을 참조하세요구성 생성. MediaTailor API의 경우 API 참조의 섹션을 AWS Elemental MediaTailor 참조PutPlaybackConfiguration하세요.
MediaTailor에서 내보내는 로그 및 이벤트 유형 목록은 매니페스트 로그, ADS 로그및 단원을 참조하십시오로그 트랜스코딩.