翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS Elemental MediaTailor ログとイベントのフィルタリング
<a name="logs-filter"></a>

MediaTailor の再生設定から出力されるログには、再生セッション中に発生するさまざまなアクティビティに関する情報が含まれます。これらのアクティビティは、ログのイベントタイプで識別されます。多くのイベントはデフォルトでログに記録されます。Amazon CloudWatch のログのコストを制御するために、MediaTailor が出力するログを指定できます。

MediaTailor では、ログフィルタリングを制御できるため、以下を実行できます。
+ ログから除外するログイベントを指定する
+ 広告決定サーバー (ADS) からの raw レスポンスのログ記録を有効にする

これらのログフィルタリング設定は、再生セッションごとに個別に設定することも、再生設定のすべての再生セッションのデフォルトとして設定することもできます。
+ セッションごとにログをフィルタリングするには、再生セッションの初期化リクエストにクエリパラメータを含めます。
+ 再生設定ごとにログをフィルタリングするには、MediaTailor コンソールまたは API を使用して、再生設定で設定を指定します。

以下のセクションでは、セッションと再生設定でログフィルタリングを有効にする手順について説明します。

# セッションごとのログフィルター
<a name="logs-filter-session"></a>

各セッションのカスタマイズされたログ詳細レベルを定義するには、最初のサーバー側またはクライアント側の再生セッションリクエストに次のパラメータを追加します。パラメータに値を追加して、含めるイベントまたは除外するイベントをカンマ区切り形式で表します。
+ `aws.adsInteractionLogPublishOptInEventTypes` は、特定の広告決定サーバー (ADS) インタラクションのログを受信します。
+ `aws.adsInteractionLogExcludeEventTypes` は、特定の ADS インタラクションのログの受信を停止します。
+ `aws.manifestServiceLogExcludeEventTypes` は、特定のマニフェストサービスインタラクションのログの受信を停止します。

MediaTailor が出力するログとイベントタイプのリストについては、「」、[ADS ログ](ads-log-format.md)「」、[マニフェストログ](log-types.md)「」を参照してください[トランスコードログ](tm-log-format.md)。

ログフィルタリングのクエリパラメータを渡さない場合、MediaTailor はすべてのログを配信先に書き込みます。

**Example ログフィルターを使用したサーバー側のセッションの初期化**  
マニフェストログと 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 から raw ログを有効にするには、 `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`と 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"
   }
```

# 再生ごとの設定ログフィルター
<a name="logs-filter-config"></a>

再生設定を使用して、MediaTailor がこの再生設定からデフォルトとして出力するログイベントタイプを定義します。MediaTailor は、セッション初期化リクエストのクエリパラメータのフィルタリングを含まないすべてのセッションに対して、これらのデフォルトのログフィルタリング設定を使用します。

以下を実行できます。
+ 特定の広告決定サーバー (ADS) インタラクションのログを受信します。
+ 特定の ADS インタラクションのログを除外します。
+ 特定のマニフェストサービスインタラクションのログを除外します。

MediaTailor コンソールからこれらの設定を行うには、「」を参照してください[設定の作成](configurations-create.md)。MediaTailor API については、 API *AWS Elemental MediaTailor リファレンス*[https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html)の「」を参照してください。

MediaTailor が出力するログとイベントタイプのリストについては、「」、[ADS ログ](ads-log-format.md)「」、[マニフェストログ](log-types.md)「」を参照してください[トランスコードログ](tm-log-format.md)。