

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

# データを送信するように Kinesis エージェントを設定する
<a name="writing-with-agents"></a>

Amazon Kinesis エージェントは、Firehose にデータを収集および送信する方法を示すリファレンス実装として機能する、スタンドアロン Java ソフトウェアアプリケーションです。このエージェントは一連のファイルを継続的に監視し、新しいデータを Firehose ストリームに送信します。エージェントは、ファイルのローテーション、チェックポイント、および障害時の再試行を処理する方法を示します。信頼性が高く、適時かつシンプルな態様でデータを配信する方法を示します。また、ストリーミングプロセスをより適切にモニタリングおよびトラブルシューティングするために、CloudWatch メトリクスを発行する方法も示します。詳細については、[awslabs/amazon-kinesis-agent](https://github.com/awslabs/amazon-kinesis-agent) を参照してください。

デフォルトでは、レコードは改行文字 (`'\n'`) に基づいて各ファイルから解析されます。しかし、複数行レコードを解析するよう、エージェントを設定することもできます ([エージェント構成設定を指定する](agent-config-settings.md)を参照)。

このエージェントは、ウェブサーバー、ログサーバーおよびデータベースサーバーなど、Linux ベースのサーバー環境にインストールできます。エージェントをインストールした後で、モニタリングするファイルとデータ用の Firehose ストリームを指定して設定します。エージェントが設定されると、ファイルから永続的にデータを収集して、Firehose ストリームに安全にデータを送信します。

## 前提条件
<a name="prereqs"></a>

Kinesis Agent の使用を開始する前に、次の前提条件を満たしていることを確認してください。
+ オペレーティングシステムは Amazon Linux、または Red Hat Enterprise Linux バージョン 7 以降でなければなりません。
+ エージェントバージョン 2.0.0 以降は JRE バージョン 1.8 以降を使用して実行されます。エージェントバージョン 1.1.x は JRE 1.7 以降を使用して実行されます。
+ Amazon EC2 を使用してエージェントを実行している場合は、EC2 インスタンスを起動します。
+ 指定する IAM ロールまたは AWS 認証情報には、エージェントが Firehose ストリームにデータを送信するために Amazon Data Firehose [PutRecordBatch](https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html) オペレーションを実行するアクセス許可が必要です。エージェントの CloudWatch モニタリングを有効にしている場合は、CloudWatch [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html) オペレーションを実行する権限も必要になります。詳細については、「[Amazon Data Firehose によるアクセスの制御](controlling-access.md)」、「[Kinesis エージェントの状態をモニタリングする](agent-health.md)」、および「[CloudWatch Amazon CloudWatch に対する認証とアクセスコントロール](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)」を参照してください。