翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
MediaTailor の再生設定から出力されるログには、再生セッション中に発生するさまざまなアクティビティに関する情報が含まれます。これらのアクティビティはログのイベントタイプで識別され、多くのイベントがデフォルトでログに記録されます。ログのボリュームは Amazon CloudWatch のコストに影響を与える可能性があり、セッション間で異なる詳細レベルが必要になる可能性があるため、MediaTailor はログに記録されるイベントタイプの制御を提供します。セッションの初期化時にクエリパラメータを使用すると、次のことができます。
-
オプトインするログイベントを指定する
-
広告決定サーバー (ADS) からの raw レスポンスのログ記録を有効にする
各セッションのログ詳細のカスタマイズされたレベルを定義するには、最初のサーバー側またはクライアント側の再生セッションリクエストに次のパラメータを追加します。パラメータに値を追加して、含めるイベントまたは除外するイベントをカンマ区切り形式で表します。
-
aws.adsInteractionLogPublishOptInEventTypesは、特定の広告決定サーバー (ADS) インタラクションのログを受信します。 -
aws.adsInteractionLogExcludeEventTypesは、特定の ADS インタラクションのログの受信を停止します。 -
aws.manifestServiceLogExcludeEventTypesは、特定のマニフェストサービスインタラクションのログの受信を停止します。
注記
ManifestService ログを受信するには、デバッグモードが有効になっている必要があります。デバッグログモードを有効にする方法などの詳細については、「」を参照してくださいデバッグログの生成。
MediaTailor が出力するログとイベントタイプのリストについては、「」を参照してくださいマニフェストログ。
ログフィルタリングのクエリパラメータを渡さない場合、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_REQUESTADS から raw ログを有効にするには、 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と ADS ログMAKING_ADS_REQUESTから および PARSING_ERRORイベントを除外します。
POST parent.m3u8
{
"adsInteractionLog": {
...
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
} ADS から raw ログを有効にするには、 publishOptInEventTypesパラメータRAW_ADS_RESPONSE の値を含めます。
POST parent.m3u8
{
"adsInteractionLog": {
"publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
}