

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

# チュートリアル: Windows 用 Kinesis エージェントを使用して JSON ログファイルを Amazon S3 にストリーミング
<a name="directory-source-to-s3-tutorial"></a>

このチュートリアルでは、Microsoft Windows 用 Amazon Kinesis Agent (Windows 用 Kinesis Agent) を使用してデータパイプラインをセットアップするための詳細な手順を示します。

このチュートリアルには次のステップが含まれます。
+ Windows 用の Kinesis Agent を使用して JSON 形式のログファイルをにストリーム処理する[Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/gsg/)経由[Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/)。Windows 用 Kinesis エージェントの詳細については、[Amazon Kinesis Agent とは何ですか?](what-is-kinesis-agent-windows.md)。
+ オブジェクトのデコレーションを使用してストリーミングする前にログデータを強化します。詳細については、「[シンクデコレーションの設定](sink-object-declarations.md#configuring-kinesis-agent-windows-decoration-configuration)」を参照してください。
+ を使用する[Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/)を使用して、特定の種類のログレコードを検索します。

**Prerequisites**  
AWS アカウントをまだ持っていない場合は、」の手順に従ってください。[AWS アカウントのセットアップ](getting-started.md#getting-started-setting-up)を得る。

**Topics**
+ [ステップ 1: AWS のサービスを設定する](kaw-ds2s3-tutorial-step1.md)
+ [ステップ 2: Windows 用 Kinesis エージェントのインストール、構成、実行](kaw-ds2s3-tutorial-step2.md)
+ [ステップ 3: Amazon S3 のログデータにクエリを実行する](kaw-ds2s3-tutorial-step3.md)
+ [次のステップ](#kaw-ds2s3-tutorial-step4-next)

# ステップ 1: AWS のサービスを設定する
<a name="kaw-ds2s3-tutorial-step1"></a>

以下の手順に従って、Microsoft Windows 用 Amazon Kinesis Agent を使用して Amazon Simple Storage Service (Amazon S3) にログデータをストリーミングするためにお客様の環境を準備します。詳細と前提条件については、[チュートリアル: Windows 用 Kinesis エージェントを使用して JSON ログファイルを Amazon S3 にストリーミング](directory-source-to-s3-tutorial.md) を参照してください。

AWS マネジメントコンソールを使用して、AWS Identity and Access Management（IAM）、Amazon S3、Kinesis Data Firehose e、および Amazon Elastic Compute Cloud (Amazon EC2) を設定し、EC2 インスタンスから Amazon S3 へのログデータのストリーミングを準備します。

**Topics**
+ [IAM ポリシーおよびロールを設定する](#kaw-ds2s3-tutorial-step1.1)
+ [Amazon S3 バケットを作成する](#kaw-ds2s3-tutorial-step1.2)
+ [Kinesis Data Firehose 配信ストリームの作成](#kaw-ds2s3-tutorial-step1.3)
+ [Windows 用 Kinesis エージェントを実行する Amazon EC2 インスタンスの作成](#kaw-ds2s3-tutorial-step1.4)
+ [次のステップ](#kaw-ds2s3-tutorial-next)

## IAM ポリシーおよびロールを設定する
<a name="kaw-ds2s3-tutorial-step1.1"></a>

以下のポリシーを作成し、Kinesis Agent for Windows が特定の Kinesis Data Firehose 配信ストリームにレコードをストリーミングすることを承認します。

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "firehose:PutRecord",
                "firehose:PutRecordBatch"
            ],
            "Resource": "arn:aws:firehose:region:account-id:deliverystream/log-delivery-stream"
        }
    ]
}
```

置換*`region`*を Kinesis Data Firehose 配信ストリームが作成される AWS リージョンの名前に置き換えます (`us-east-1`など）。*`account-id`* を配信ストリームが作成される AWS アカウントの 12 桁のアカウント ID に置き換えます。

 ナビゲーションバーで、[] を選択します。**サポート**を選択し、**サポートセンター**。現在サインインしている 12 桁のアカウント番号 (ID) が [] に表示されます。**サポートセンター**ナビゲーションペイン。

次の手順に従ってポリシーを作成します。ポリシー `log-delivery-stream-access-policy` に名前を付けます。

**JSON ポリシーエディタを使用してポリシーを作成するには**

1. AWS マネジメントコンソールにサインインして、IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。

1. 左側にあるナビゲーションペインで、[**ポリシー**] を選択します。

   初めて [**ポリシー**] を選択する場合には、[**管理ポリシーにようこそ**] ページが表示されます。[**Get Started**] を選択します。

1. ページの上部で、[**ポリシーの作成**] を選択します。

1. [**JSON**] タブを選択します。

1. JSON ポリシードキュメントを入力します。IAM ポリシー言語の詳細については、「」を参照してください。[IAM JSON ポリシーリファレンス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html)()*IAM ユーザーガイド*。

1. 完了したら、[**ポリシーの確認**] を選択します。[Policy Validator](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_policy-validator.html) によって、構文エラーがある場合はレポートされます。
**注記**  
いつでも [**Visual editor (ビジュアルエディタ)**] タブと [**JSON**] タブを切り替えることができます。ただし、変更を加えたり、**ポリシーの確認**()**Visual editor (ビジュアルエディタ)**] タブで、IAM はポリシーを再構成してビジュアルエディタに合わせて最適化することがあります。詳細については、「」を参照してください。[ポリシーの再構成](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure)()*IAM ユーザーガイド*。

1. [**ポリシーの確認**] ページに作成するポリシーの [**名前**] と [**説明**] (オプション) を入力します。ポリシーの [**概要**] を確認して、ポリシーで許可されている権限を確認します。次に [**ポリシーの作成**] を選択して作業を保存します。

![\[Kinesis Data Firehose の IAM ポリシーを作成する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/iam-create-kdf-policy.png)


**S3 バケットへのアクセス権をKinesis Data Firehose に付与するロールを作成するには**

1. 前の手順を使用して、以下の JSON を使用して定義される `firehose-s3-access-policy` という名前のポリシーを作成します。

   ```
   {
       "Version": "2012-10-17",  
       "Statement":
       [    
           {      
               "Effect": "Allow",      
               "Action": [        
                   "s3:AbortMultipartUpload",        
                   "s3:GetBucketLocation",        
                   "s3:GetObject",        
                   "s3:ListBucket",        
                   "s3:ListBucketMultipartUploads",        
                   "s3:PutObject"
               ],      
               "Resource": [        
                   "arn:aws:s3:::bucket-name",
                   "arn:aws:s3:::bucket-name/*"		    
               ]    
           },
           {
              "Effect": "Allow",
              "Action": [
                  "logs:PutLogEvents"
              ],
              "Resource": [
                  "arn:aws:logs:region:account-id:log-group:firehose-error-log-group:log-stream:firehose-error-log-stream"
              ]
           }
       ]
   }
   ```

   *`bucket-name`* をログが保存される一意のバケット名に置き換えます。置換*`region`*CloudWatch Logs ロググループとログストリームが作成される AWS リージョンを使用します。これらは、Kinesis Data Firehose 経由でデータを Amazon S3 にストリーミングしているときにエラーが発生した場合にログを記録するためのものです。*`account-id`* をロググループとログストリームが作成されるアカウントの 12 桁のアカウント ID に置き換えます。  
![\[Amazon S3 へのアクセスを許可する IAM ポリシーを作成する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/iam-create-s3-policy.png)

1. IAM コンソールのナビゲーションペインで、[**Roles**]、[**Create role**] の順に選択します。

1. [**AWS サービス**ロールタイプを選択してから、[] を選択します。**Kinesis**のサービス。

1. 選択**Kinesis Data Firehose**ユースケースに [] を選択してから、[] を選択します。**次へ: アクセス許可。**

1. 検索ボックスに「」と入力します。**firehose-s3-access-policy**] を選択し、そのポリシーを選択してから、[] を選択します。**次へ: 確認**。

1. [**ロール名**] ボックスに、「**firehose-s3-access-role**」と入力します。

1. [**ロールの作成**] を選択します。

**Kinesis Agent for Windows を実行する EC2 インスタンスのインスタンスプロファイルに関連付けるロールを作成するには**

1. IAM コンソールのナビゲーションペインで、[**Roles**]、[**Create role**] の順に選択します。

1. [**AWS サービス**ロールタイプを選択し、[] を選択します。**EC2**。

1. 選択**次へ: アクセス許可。**

1. 検索ボックスに「**log-delivery-stream-access-policy**」と入力します。

1. ポリシーを選択し、[] メニューから [] を選択します。**次へ: 確認**。

1. [**ロール名**] ボックスに、「**kinesis-agent-instance-role**」と入力します。

1. [**ロールの作成**] を選択します。

## Amazon S3 バケットを作成する
<a name="kaw-ds2s3-tutorial-step1.2"></a>

 Kinesis Data Firehose がログをストリーミングする S3 バケットを作成します。

**ログストレージ用 S3 バケットを作成するには**

1. Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。

1. [**バケットを作成する**] を選択します。

1. [**バケット名**] ボックスに、[IAM ポリシーおよびロールを設定する](#kaw-ds2s3-tutorial-step1.1) で選択した一意の S3 バケット名を入力します。

1. バケットを作成するリージョンを選択します。通常、これは Kinesis Data Firehose 配信ストリームと Amazon EC2 インスタンスを作成するのと同じリージョンです。

1. [**作成**] を選択します。

## Kinesis Data Firehose 配信ストリームの作成
<a name="kaw-ds2s3-tutorial-step1.3"></a>

Amazon S3 にストリーム処理されたレコードを保存する Kinesis Data Firehose 配信ストリームを作成します。

**Kinesis Data Firehose 配信ストリームを作成するには**

1. Kinesis Data Firehose e コンソール ([https://console.aws.amazon.com/firehose/](https://console.aws.amazon.com/firehose/)。

1. [**Create Delivery Stream**] を選択します。

1. [**Delivery stream name (配信ストリーム名)**] ボックスに「**log-delivery-stream**」と入力します。

1. [**ソース**] で、[**Direct PUT or other sources (Direct PUT またはその他のソース)**] を選択します。  
![\[Kinesis Data Firehose 配信ストリームの作成時にソースを指定する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/fh-create-delivery-stream-1.png)

1. [**Next**] を選択します。

1. [**次へ**] をもう一度選択します。

1. 送信先として [] を選択します。**Amazon S3**。

1. [**S3 バケット**] に [Amazon S3 バケットを作成する](#kaw-ds2s3-tutorial-step1.2) で作成したバケットの名前を選択します。  
![\[Kinesis Data Firehose 配信ストリームの作成時に送信先を指定する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/fh-create-delivery-stream-2.png)

1. [**Next**] を選択します。

1. [**Buffer interval (バッファ間隔)**] ボックスに「**60**」と入力します。

1. [**IAM ロール**] で、[**Create new or choose (新規作成または選択する)**] を選択します。

1. [**IAM ロール**] に `firehose-s3-access-role` を選択します。

1. [**許可**] を選択します。  
![\[Kinesis Data Firehose 配信ストリームの作成時にオプションとセキュリティを設定する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/fh-create-delivery-stream-3.png)

1. [**Next**] を選択します。

1. [**Create delivery stream (配信ストリームの作成)**] を選択します。

## Windows 用 Kinesis エージェントを実行する Amazon EC2 インスタンスの作成
<a name="kaw-ds2s3-tutorial-step1.4"></a>

Kinesis Data Firehose 経由でログレコードをストリーミングするために Kinesis Agent for Windows を使用する EC2 インスタンスを作成します。

**EC2 インスタンスを作成するには**

1. Amazon EC2 コンソール ([https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)) を開きます。

1. 次の追加ステップを使用して、[Amazon EC2 Windows インスタンスの使用開始](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2_GetStarted.html)の指示に従います。
   + インスタンスの [**IAM ロール**] に `kinesis-agent-instance-role` を選択します。
   + インターネットに接続しているパブリックの Virtual Private Cloud (VPC) をまだ作成していない場合は、[Amazon EC2 での設定](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/get-set-up-for-amazon-ec2.html)()*Windows インスタンス用の Amazon EC2 ユーザーガイド*。
   + ユーザーのコンピュータからのみ、またはユーザーの組織のコンピュータからのみにインスタンスへのアクセスを制限するセキュリティグループを作成または使用します。詳細については、「」を参照してください。[Amazon EC2 での設定](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/get-set-up-for-amazon-ec2.html)()*Windows インスタンス用の Amazon EC2 ユーザーガイド*。
   + 既存のキーペアを指定する場合は、そのキーペアのプライベートキーにアクセスできることを確認します。または、新規キーペアを作成し、安全な場所にプライベートキーを保存します。
   + 続行する前に、インスタンスが実行され、2 つのうち 2 つのヘルスチェックが完了するまで待機します。
   + インスタンスにはパブリック IP アドレスが必要です。割り当てられていない場合は、[Elastic IP アドレス](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/elastic-ip-addresses-eip.html)()*Windows インスタンス用の Amazon EC2 ユーザーガイド*。

## 次のステップ
<a name="kaw-ds2s3-tutorial-next"></a>

[ステップ 2: Windows 用 Kinesis エージェントのインストール、構成、実行](kaw-ds2s3-tutorial-step2.md)

# ステップ 2: Windows 用 Kinesis エージェントのインストール、構成、実行
<a name="kaw-ds2s3-tutorial-step2"></a>

このステップでは、AWS マネジメントコンソールを使用して、で起動したインスタンスにリモートで接続します。[Windows 用 Kinesis エージェントを実行する Amazon EC2 インスタンスの作成](kaw-ds2s3-tutorial-step1.md#kaw-ds2s3-tutorial-step1.4)。次に、インスタンスに Microsoft Windows 用 Amazon Kinesis Agent をインストールし、Kinesis Agent for Windows 用の設定ファイルを作成およびデプロイして、**AWSkineSistap**のサービス。

1. Remore Desktop Protocol (RDP) 経由でリモートでインスタンスに接続するには、[ステップ 2: インスタンスへの接続](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2_GetStarted.html#ec2-connect-to-instance-windows)()*Windows インスタンス用の Amazon EC2 ユーザーガイド*。

1. インスタンスで、Windows Server Manager を使用して、ユーザーと管理者の Microsoft Internet Explorer セキュリティ強化の構成を無効にします。詳細については、Microsoft TechNet ウェブサイトの [How To Turn Off Internet Explorer Enhanced Security Configuration](https://blogs.technet.microsoft.com/chenley/2011/03/10/how-to-turn-off-internet-explorer-enhanced-security-configuration/) を参照してください。

1. インスタンスで、Windows 用 Kinesis エージェントをインストールして設定します。詳細については、「[Windows 用 Kinesis エージェントのインストール](getting-started.md#getting-started-installation)」を参照してください。

1. インスタンスで、メモ帳を使用して Kinesis Agent for Windows 設定ファイルを作成します。ファイルを `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` に保存します。設定ファイルに以下のコンテンツを追加します。

   ```
   {
     "Sources": [
       {
         "Id": "JsonLogSource",
         "SourceType": "DirectorySource",
         "RecordParser": "SingleLineJson",
         "Directory": "C:\\LogSource\\",
         "FileNameFilter": "*.log",
         "InitialPosition": 0
       }
     ],
     "Sinks": [
       {
         "Id": "FirehoseLogStream",
         "SinkType": "KinesisFirehose",
         "StreamName": "log-delivery-stream",
         "Region": "us-east-1",
         "Format": "json",
         "ObjectDecoration": "ComputerName={ComputerName};DT={timestamp:yyyy-MM-dd HH:mm:ss}"
       }
     ],
     "Pipes": [
       {
         "Id": "JsonLogSourceToFirehoseLogStream",
         "SourceRef": "JsonLogSource",
         "SinkRef": "FirehoseLogStream"
       }
     ]
   }
   ```

   このファイルは、Kinesis Agent for Windows が JSON 形式のログレコードを`c:\logsource\`ディレクトリ (*source*) を Kinesis Data Firehose 配信ストリームに`log-delivery-stream`(*sink*). 各ログレコードが Kinesis Data Firehose にストリーミングされる前に、コンピュータの名前とタイムスタンプが格納されている 2 つの追加のキーと値のペアによって強化されます。

1. `c:\LogSource\` ディレクトリを作成し、メモ帳を使用して、そのディレクトリに以下の内容の `test.log` ファイルを作成します。

   ```
   { "Message": "Copasetic message 1", "Severity": "Information" }
   { "Message": "Copasetic message 2", "Severity": "Information" }
   { "Message": "Problem message 2", "Severity": "Error" }
   { "Message": "Copasetic message 3", "Severity": "Information" }
   ```

1. 昇格された PowerShell セッションで、次のコマンドを使用して **AWSKinesisTap** サービスを開始します。

   ```
   Start-Service -ServiceName AWSKinesisTap
   ```

1. ファイルエクスプローラーで、`%PROGRAMDATA%\Amazon\AWSKinesisTap\logs` ディレクトリを参照します。最新のログファイルを開きます。ログファイルは次のようになります。

   ```
   2018-09-28 23:51:02.2472 Amazon.KinesisTap.Hosting.LogManager INFO Registered factory Amazon.KinesisTap.AWS.AWSEventSinkFactory.
   2018-09-28 23:51:02.2784 Amazon.KinesisTap.Hosting.LogManager INFO Registered factory Amazon.KinesisTap.Windows.PerformanceCounterSinkFactory.
   2018-09-28 23:51:02.5753 Amazon.KinesisTap.Hosting.LogManager INFO Registered factory Amazon.KinesisTap.Core.DirectorySourceFactory.
   2018-09-28 23:51:02.5909 Amazon.KinesisTap.Hosting.LogManager INFO Registered factory Amazon.KinesisTap.ExchangeSource.ExchangeSourceFactory.
   2018-09-28 23:51:02.5909 Amazon.KinesisTap.Hosting.LogManager INFO Registered factory Amazon.KinesisTap.Uls.UlsSourceFactory.
   2018-09-28 23:51:02.5909 Amazon.KinesisTap.Hosting.LogManager INFO Registered factory Amazon.KinesisTap.Windows.WindowsSourceFactory.
   2018-09-28 23:51:02.9347 Amazon.KinesisTap.Hosting.LogManager INFO Registered factory Amazon.KinesisTap.Core.Pipes.PipeFactory.
   2018-09-28 23:51:03.5128 Amazon.KinesisTap.Hosting.LogManager INFO Registered factory Amazon.KinesisTap.AutoUpdate.AutoUpdateFactory.
   2018-09-28 23:51:03.5440 Amazon.KinesisTap.Hosting.LogManager INFO Performance counter sink  started.
   2018-09-28 23:51:03.7628 Amazon.KinesisTap.Hosting.LogManager INFO KinesisFirehoseSink id FirehoseLogStream for StreamName log-delivery-stream started.
   2018-09-28 23:51:03.7784 Amazon.KinesisTap.Hosting.LogManager INFO Connected source JsonLogSource to sink FirehoseLogStream
   2018-09-28 23:51:03.7940 Amazon.KinesisTap.Hosting.LogManager INFO DirectorySource id JsonLogSource watching directory C:\LogSource\ with filter *.log started.
   ```

   このログファイルは、サービスが開始され、`c:\LogSource\` ディレクトリからログレコードが収集されていることを示します。各行は、単一の JSON オブジェクトとして解析されます。コンピュータ名とタイムスタンプのキーと値のペアが各オブジェクトに追加されます。その後、Kinesis Data Firehose にストリーム処理されます。

1. 1 ～ 2 分で、で作成した Amazon S3 バケットに移動します。[Amazon S3 バケットを作成する](kaw-ds2s3-tutorial-step1.md#kaw-ds2s3-tutorial-step1.2)AWS マネジメントコンソールを使用して。コンソールで正しいリージョンを選択したことを確認してください。

   そのバケットは、現在の年のフォルダがあります。そのフォルダを開き、現在のフォルダを表示します。そのフォルダを開き、当日のフォルダを表示します。そのフォルダを開き、現在の時間 (UTC) のフォルダを表示します。そのフォルダを開き、`log-delivery-stream` の名前で始まる 1 つ以上の項目を表示します。  
![\[Amazon S3 のログレコードを参照する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/s3-view-log-stream.png)

1. 最新の項目の内容を開き、ログレコードが必要な機能強化により Amazon S3 に正常に保存されていることを確認します。すべてが正しく設定されている場合、次のような内容になります。

   ```
   {"Message":"Copasetic message 1","Severity":"Information","ComputerName":"EC2AMAZ-ABCDEFGH","DT":"2018-09-28 23:51:04"}
   {"Message":"Copasetic message 2","Severity":"Information","ComputerName":"EC2AMAZ-ABCDEFGH","DT":"2018-09-28 23:51:04"}
   {"Message":"Problem message 2","Severity":"Error","ComputerName":"EC2AMAZ-ABCDEFGH","DT":"2018-09-28 23:51:04"}
   {"Message":"Copasetic message 3","Severity":"Information","ComputerName":"EC2AMAZ-ABCDEFGH","DT":"2018-09-28 23:51:04"}
   ```

1. 以下のいずれかの問題を解決するための情報については、[Microsoft Windows 用 Amazon Kinesis エージェントのトラブルシューティング](troubleshooting-kinesis-agent-windows.md) を参照してください。
   + Windows 用の Kinesis Agent のログファイルにエラーがあります。
   + Amazon S3 の予期されたフォルダや項目が存在しません。
   + Amazon S3 の項目の内容が正しくない。

## 次のステップ
<a name="kaw-ds2s3-tutorial-step2-next"></a>

[ステップ 3: Amazon S3 のログデータにクエリを実行する](kaw-ds2s3-tutorial-step3.md)

# ステップ 3: Amazon S3 のログデータにクエリを実行する
<a name="kaw-ds2s3-tutorial-step3"></a>

Microsoft Windows 向けこの Amazon Kinesis エージェントの最後のステップで[チュートリアル](directory-source-to-s3-tutorial.md)では、Amazon Athena を使用して Amazon Simple Storage Service (Amazon S3) に保存されたログデータをクエリします。

1. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) で Athena コンソールを開きます。

1. プラス記号 (**\$1**) Athena、新しいクエリウィンドウを作成します。  
![\[Athena で新しいクエリウィンドウを作成する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/athena-new-query.png)

1. 次の内容をクエリウィンドウに入力します。

   ```
   CREATE DATABASE logdatabase
   
   CREATE EXTERNAL TABLE logs (
     Message string,
     Severity string,
     ComputerName string,
     DT timestamp
   )
   ROW FORMAT SERDE 'org.openx.data.jsonserde.JsonSerDe'
   LOCATION 's3://bucket/year/month/day/hour/'
   
   SELECT * FROM logs
   SELECT * FROM logs WHERE severity = 'Error'
   ```

   *`bucket`* を [Amazon S3 バケットを作成する](kaw-ds2s3-tutorial-step1.md#kaw-ds2s3-tutorial-step1.2) で作成したバケットの名前に置き換えます。置換*`year`*,*`month`*,*`day`*および*`hour`*を Amazon S3 ログファイルが作成されたときの年、月、日と時間 (UTC) で指定します。

1. `CREATE DATABASE` ステートメントにテキストを選択し、[**クエリの実行**] を選択します。これにより、Athena にログデータベースが作成されます。

1. `CREATE EXTERNAL TABLE` ステートメントにテキストを選択し、[**クエリの実行**] を選択します。これで、JSON のスキーマを Athena テーブルのスキーマにマッピングして、ログデータで S3 バケットを参照する Athena テーブルが作成されます。

1. 最初の `SELECT` ステートメントにテキストを選択し、[**クエリの実行**] を選択します。テーブルのすべての行が表示されます。  
![\[Athena を使用してログレコードにクエリを実行する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/athena-first-select.png)

1. 2 番目の `SELECT` ステートメントにテキストを選択し、[**クエリの実行**] を選択します。`Error` の緊急度のログレコードを表すテーブル内の行のみが表示されます。このようなクエリでは、サイズが大きい可能性があるログレコードから興味深いログレコードが見つかります。  
![\[Athena の特定の種類のレコードにクエリを実行する方法を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/kinesis-agent-windows/latest/userguide/images/athena-second-query.png)

## 次のステップ
<a name="kaw-ds2s3-tutorial-step4-next"></a>

AWS マネジメントコンソールを使用して、チュートリアルで作成されたリソースをクリーンアップします。

1. EC2 インスタンスを終了します ([Amazon EC2 Windows インスタンスの使用開始](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2_GetStarted.html#ec2-connect-to-instance-windows)のステップ 3 を参照してください)。
**重要**  
内にないインスタンスを起動した場合、[AWS 無料利用枠](https://aws.amazon.com/free/)に設定されている場合、インスタンスを終了するまでそのインスタンスに対して課金されます。

1. Kinesis Data Firehose 配信ストリームを削除します。

   1. Kinesis Data Firehose e コンソール ([https://console.aws.amazon.com/firehose/](https://console.aws.amazon.com/firehose/)。

   1. 作成した配信ストリームを選択します。

   1. [**削除**] を選択します。

   1. [**Delete delivery stream (配信ストリームの削除)**] を選択します。

1. S3 バケットを削除します。手順については、以下を参照してください。[S3 バケットを削除する方法](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/delete-bucket.html)()*Amazon Simple Storage Service Console*。

詳細については、以下のトピックを参照してください。
+ [Microsoft Windows 用の Amazon Kinesis エージェントの設定](configuring-kinesis-agent-windows.md)
+ [Amazon Kinesis Data Firehose とは何ですか?](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html)
+ [Amazon S3 とは?](https://docs.aws.amazon.com/AmazonS3/latest/dev/Welcome.html)
+ [Amazon Athena とは何ですか?](https://docs.aws.amazon.com/athena/latest/ug/what-is.html)