View a markdown version of this page

筛选 AWS Elemental MediaTailor 日志和事件 - AWS Elemental MediaTailor

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

筛选 AWS Elemental MediaTailor 日志和事件

从中的回放配置发出的日志 MediaTailor 包括有关播放会话期间发生的各种活动的信息。这些活动在日志的事件类型中标识。默认情况下会记录许多事件。为了帮助控制亚马逊中的日志成本 CloudWatch，您可以指定 MediaTailor 发出的日志。

MediaTailor 允许您控制日志筛选，因此您可以执行以下操作：

  • 指定要从日志中排除的日志事件

  • 启用记录来自广告决策服务器 (ADS) 的原始响应

您可以为每个回放会话单独设置这些日志过滤首选项，或者将这些首选项设置为回放配置的所有回放会话的默认设置。

  • 要根据每个会话筛选日志，请在回放会话初始化请求中包含查询参数。

  • 要根据每次播放配置筛选日志，请使用 MediaTailor 控制台或 API 在播放配置设置中指明您的偏好。

以下部分提供了在会话和回放配置上启用日志过滤的说明。

要为每个会话定义自定义的日志详细信息级别，请将以下参数附加到您的初始服务器端或客户端播放会话请求中。以逗号分隔的格式向参数中添加值以表示要包含或排除的事件：

  • aws.adsInteractionLogPublishOptInEventTypes接收特定广告决策服务器 (ADS) 互动的日志。

  • aws.adsInteractionLogExcludeEventTypes停止接收特定 ADS 互动的日志。

  • aws.manifestServiceLogExcludeEventTypes停止接收特定清单服务交互的日志。

有关发 MediaTailor 出的日志和事件类型的列表，请参见清单日志ADS 日志、和转码日志。

如果您没有传递任何查询参数进行日志筛选，则 MediaTailor 会将所有日志写入您的传送目的地。

例使用日志过滤器初始化服务器端会话

要从清单日志GENERATED_MANIFEST和 ADS 日志MAKING_ADS_REQUEST中排除和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
例使用日志过滤器初始化客户端会话

要在客户端会话初始化期间排除日志事件，请在您的客户端 POST 请求中包含availSuppression和日志类型参数。 MediaTailor有关如何构建客户端播放会话请求的更多信息，请参阅Client-side 广告追踪。以下示例从您的清单日志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 的原始日志，请添加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，请参阅 AWS Elemental MediaTailor API 参考PutPlaybackConfiguration中的。

有关发 MediaTailor 出的日志和事件类型的列表，请参见清单日志ADS 日志、和转码日志。