本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
從 MediaTailor 中的播放組態發出的日誌包含播放工作階段期間發生的各種活動的相關資訊。這些活動會在日誌的事件類型中識別,且依預設會記錄許多事件。由於日誌數量可能會影響 Amazon CloudWatch 中的成本,而且您可能需要工作階段之間有不同層級的詳細資訊,因此 MediaTailor 會提供記錄哪些事件類型的控制。使用工作階段初始化時的查詢參數,您可以執行下列動作:
-
指定您要選擇加入的日誌事件
-
啟用記錄廣告決策伺服器 (ADS) 的原始回應
若要定義每個工作階段的自訂日誌詳細資訊層級,請將下列參數附加至初始伺服器端或用戶端播放工作階段請求。將值新增至參數,以逗號分隔格式表示您想要包含或排除的事件:
-
aws.adsInteractionLogPublishOptInEventTypes
接收特定廣告決策伺服器 (ADS) 互動的日誌。 -
aws.adsInteractionLogExcludeEventTypes
停止接收特定 ADS 互動的日誌。 -
aws.manifestServiceLogExcludeEventTypes
停止接收特定資訊清單服務互動的日誌。
注意
您必須啟用偵錯模式,才能接收任何 ManifestService 日誌。如需偵錯日誌模式的相關資訊,包括如何啟用,請參閱 產生偵錯日誌。
如需 MediaTailor 發出的日誌和事件類型清單,請參閱 資訊清單日誌。
如果您未傳遞日誌篩選的任何查詢參數,MediaTailor 會將所有日誌寫入您的交付目的地。
範例 使用日誌篩選條件初始化伺服器端工作階段
若要從資訊清單日誌GENERATED_MANIFEST
和 MAKING_ADS_REQUEST
ADS 日誌中排除 和 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
和 日誌類型參數。如需如何建構用戶端播放工作階段請求的詳細資訊,請參閱用戶端廣告追蹤。下列範例會從您的資訊清單日誌CONFIG_SECURITY_ERROR
和 MAKING_ADS_REQUEST
ADS 日誌中排除 和 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"
}