翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Elemental MediaTailor Amazon CloudWatch Logs Insights での ADS ログ分析
Amazon CloudWatch Logs Insights を使用して、 AWS Elemental MediaTailor 広告決定サーバー (ADS) ログを表示およびクエリできます。MediaTailor は、通常の処理とエラー状態に関するイベントログを CloudWatch に送信します。ログは JSON スキーマに従っています。CloudWatch Logs Insights を使用して、時間枠ごとにログを選択してから、それらに対してクエリを実行できます。
一般情報については、「[CloudWatch Logs Insights を使用したログデータの分析](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)」を参照してください。
**注記**
ログにアクセスするには、Amazon CloudWatch にアクセスするための許可が必要です。手順については、「[Amazon CloudWatch Logs のアクセス許可](monitoring-permissions.md)」を参照してください。
**CloudWatch コンソールを使用して ADS ログを表示してクエリする**
1. CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。
1. ナビゲーションペインの **[Logs]** (ログ) で **[Insights]** (インサイト) をクリックします。
1. 検索バーで と入力し**AdDec**、ドロップダウンリストから を選択します`MediaTailor/AdDecisionServerInteractions`。
1. (オプション) 調査する期間を調整します。
1. (オプション) ダイアログボックスでクエリを変更します。一般的なガイダンスについては、「[CloudWatch Logs Insights のクエリ構文](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html)」を参照してください。MediaTailor ADS に関するクエリの例については、「[ADS ログのクエリ](querying-the-ads-logs.md)」を参照してください。
1. **[Run query]** (クエリの実行) を選択します。クエリには数秒かかる場合があり、その間は **[Run query]** (クエリの実行) の代わりに **[Cancel]** (キャンセル) が表示されます。
1. (オプション) 結果を CSV ファイルとしてエクスポートするには、[**アクション**]、[**クエリ結果のダウンロード (CSV) **]の順に選択します。
**注記**
コンソールは、クエリ結果で返されるレコードとエクスポートされるレコードの数を制限するため、バルクデータには API、 AWS Command Line Interface (AWS CLI)、または SDK を使用します。
**Topics**
+ [ADS ログのクエリ](querying-the-ads-logs.md)
# ADS ログのクエリ
CloudWatch Logs は、ログをクエリするための豊富なオプションを提供します。クエリ構文に関する詳細情報については、「[CloudWatch Logs Insights のクエリ構文](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html)」を参照してください。このセクションには、ADS ログクエリの使用を開始するための一般的なクエリの例が記載されています。すべてのクエリは、現在の時間範囲設定のログに対して実行されます。
以下のクエリは、ADS ログからすべての情報を取得します。
```
fields @timestamp, eventType, sessionId, requestId, @message
| sort sessionId, @timestamp asc
```
以下のクエリは、ADS に対するすべてのリクエストを取得します。このクエリは、MediaTailor ログのリクエストヘッダーコンテンツを取得する方法を示しています。
```
fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "MAKING_ADS_REQUEST"
| sort @timestamp asc
```
以下のクエリは、MediaTailor が所定のセッションに挿入した広告を取得します。
```
fields @timestamp, sessionId, requestId, @message
| filter eventType = "FILLED_AVAIL"
| sort @timestamp asc
```
以下のクエリは、MediaTailor がプレイヤーに代わって呼び出した追跡 URL を取得します。
```
fields @timestamp, beaconInfo.trackingEvent, beaconInfo.beaconUri, beaconInfo.headers.0.value as @userAgent, beaconInfo.headers.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "BEACON_FIRED"
| sort @timestamp asc
```
以下のクエリは、`sessionId` で結果をフィルタリングすることによって、特定の再生セッションの情報を取得します。
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195"
| sort @timestamp asc
```
以下のクエリは、`requestId` で結果をフィルタリングすることによって、単一のリクエストの情報を取得します。
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d"
| sort @timestamp asc
```
以下のクエリは、ログに記録された各イベントタイプのログエントリの数を取得します。
```
fields eventType
| stats count() as @eventCount by eventType
```
以下のクエリは、広告をスキップしたすべての avail に対する avail ID とスキップされた広告のリストを取得します。
```
fields avail.availId
| parse @message '"skippedAds":[*]' as @skippedAdsList
| filter ispresent(@skippedAdsList)
```