本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 篩選 AWS Elemental MediaTailor 日誌和事件
<a name="logs-filter"></a>

從 MediaTailor 中的播放組態發出的日誌包含播放工作階段期間發生的各種活動的相關資訊。這些活動會在日誌的事件類型中識別。預設會記錄許多事件。若要協助控制 Amazon CloudWatch 中的日誌成本，您可以指定 MediaTailor 發出的日誌。

MediaTailor 可讓您控制日誌篩選，以便執行下列動作：
+ 指定您要從日誌中排除的日誌事件
+ 啟用記錄廣告決策伺服器 (ADS) 的原始回應

您可以為每個播放工作階段分別設定這些日誌篩選偏好設定，或做為播放組態之所有播放工作階段的預設值。
+ 若要依工作階段篩選日誌，請在播放工作階段初始化請求中包含查詢參數。
+ 若要根據每個播放組態篩選日誌，請使用 MediaTailor 主控台或 API 在播放組態設定中指出您的偏好設定。

下列各節提供在工作階段和播放組態上啟用日誌篩選的指示。

# 每個工作階段日誌篩選條件
<a name="logs-filter-session"></a>

若要定義每個工作階段的自訂日誌詳細資訊層級，請將下列參數附加至您的初始伺服器端或用戶端播放工作階段請求。將值新增至參數，以逗號分隔格式表示您想要包含或排除的事件：
+ `aws.adsInteractionLogPublishOptInEventTypes` 接收特定廣告決策伺服器 (ADS) 互動的日誌。
+ `aws.adsInteractionLogExcludeEventTypes` 停止接收特定 ADS 互動的日誌。
+ `aws.manifestServiceLogExcludeEventTypes` 停止接收特定資訊清單服務互動的日誌。

如需 MediaTailor 發出的日誌和事件類型清單，請參閱 [資訊清單日誌](log-types.md)、 [ADS 日誌](ads-log-format.md)和 [轉碼日誌](tm-log-format.md)。

如果您未傳遞日誌篩選的任何查詢參數，MediaTailor 會將所有日誌寫入您的交付目的地。

**Example 使用日誌篩選條件初始化伺服器端工作階段**  
若要從資訊清單日誌`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
```

**Example 使用日誌篩選條件進行用戶端工作階段初始化**  
若要在用戶端工作階段初始化期間排除日誌事件，請在用戶端對 MediaTailor 的 POST 請求中包含 `availSuppression`和 日誌類型參數。如需如何建構用戶端播放工作階段請求的詳細資訊，請參閱[用戶端廣告追蹤](ad-reporting-client-side.md)。下列範例會從您的資訊清單日誌`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"
   }
```

# 每個播放組態日誌篩選條件
<a name="logs-filter-config"></a>

使用播放組態的設定，將 MediaTailor 發出的日誌事件類型定義為此播放組態中的預設值。MediaTailor 會針對工作階段初始化請求上不包含篩選查詢參數的所有工作階段，使用這些預設日誌篩選設定。

您可以選擇執行下列動作：
+ 接收特定廣告決策伺服器 (ADS) 互動的日誌。
+ 排除特定 ADS 互動的日誌。
+ 排除特定資訊清單服務互動的日誌。

若要從 MediaTailor 主控台設定這些設定，請參閱 [建立組態](configurations-create.md)。如需 MediaTailor API，請參閱*AWS Elemental MediaTailor 《 API 參考*[https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html)》中的 。

如需 MediaTailor 發出的日誌和事件類型清單，請參閱 [資訊清單日誌](log-types.md)、 [ADS 日誌](ads-log-format.md)和 [轉碼日誌](tm-log-format.md)。