Microsoft Windows 用 Amazon Kinesis エージェントのトラブルシューティング

ソース、シンク、またはパイプが正しく設定されていない。

Windows 用 Kinesis Agent の認証が正しく設定されていない。

Windows 用 Kinesis Agent の承認が正しく設定されていない。

DirectorySource 宣言で提供された正規表現にエラーがある。

存在しないディレクトリが DirectorySource 宣言に指定されている。

AWS サービスに無効な値が指定されているため、Windows 用 Kinesis Agent からのリクエストが拒否される。

シンクが、指定された AWS リージョンまたは暗黙的な AWS リージョンに存在しないリソースを参照している。

無効なクエリが WindowsEventLogSource 宣言に指定されている。

無効な値がソースの InitialPosition キーと値のペアに指定されている。

appsettings.json 設定ファイルが目的のファイルの JSON スキーマに準拠していない。

AWS マネジメントコンソールで選択されたリージョンとは別のリージョンにデータがストリーミングされる。

Windows 用 Kinesis Agent が正しくインストールされていないか、実行中でない。

ブックマーク機能が使用されていない。

AWS サービスの現在の設定に基づいた AWS サービスのデータレート制限を超過している。

AWS サービスの API コールレートの制限を超過している。現在のappsettings.json設定ファイルと AWS アカウントの制限値を指定します。

appsettings.json 設定ファイルのシンク宣言の Format キーと値のペアの値が正しくない。

DirectorySource 宣言の RecordParser キーと値のペアの値が正しくない。

Regex レコードパーサーを使用する DirectorySource 宣言の正規表現が正しくない。

Windows 用 Kinesis Agent が実行されているマシンに、必要なデータの量をストリーミングする十分な容量がない。

不要なデータが 1 つ以上の AWS サービスにストリーミングされる。

Windows 用 Kinesis Agent は、このような高いデータ転送速度用に設定されていない AWS サービスにデータをストリーミングします。

Windows 用 Kinesis Agent が、API コールレートの制限が低すぎるアカウントで AWS サービスのオペレーションを呼び出している。

Windows 用 Kinesis Agent のログ記録設定ファイルが正しくない。

Windows 用 Kinesis Agent の永続的なキューが正しく設定されていない。

その他のいくつかのアプリケーションまたはサービスによってディスク容量が消費されている。

Windows の Kinesis Agent ログファイルが含まれているディスクのディスク容量が少ない場合は、ログファイルのディレクトリ (通常は%PROGRAMDATA%\Amazon\AWSKinesisTap\logs). 妥当な数のログファイルが保持されており、ログファイルが合理的なサイズであることを確認します。Windows 用 Kinesis Agent のログの場所、保持、および詳細レベルを制御するには、%PROGRAMFILES%\Amazon\AWSKinesisTap\Nlog.xml設定ファイルに。

シンクのキューイング機能が有効な場合は、この機能を使用するシンク宣言を調べます。QueuePath キーと値のペアが参照するディスクドライブの容量が、QueueMaxBatches キーと値のペアを使用して指定されたバッチの最大数を含むのに十分な容量であることを確認します。これができない場合は、指定されたディスクドライブの残りのディスク容量にデータが容易に適合するように QueueMaxBatches キーと値のペアの値を減らします。

Windows ファイルエクスプローラーを使用して、ディスク容量を消費しているファイルを見つけ、余分なファイルを転送または削除します。大量のディスク容量を消費しているアプリケーションまたはサービスの設定を変更します。

特定のファイルパターンを持つログファイルがディレクトリに書き込まれる場合でも、Kinesis Agent for Windows によって処理されていないと考えられる場合は、/wスイッチを使用して、これらの変更が検出されていることを確認します。たとえば、*.log ファイル名のパターンを持つログファイルが c:\foo ディレクトリに書き込まれると予想しているとします。ktdiag.exe ツールを実行する際に、ディレクトリとファイルパターンを指定して、/w スイッチを使用します。

cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
ktdiag /w c:\foo *.log

ログファイルが書き込まれている場合は、次のような出力が表示されます。

Type any key to exit this program...
File: c:\foo\log1.log ChangeType: Created
File: c:\foo\log1.log ChangeType: Deleted
File: c:\foo\log1.log ChangeType: Created
File: c:\foo\log1.log ChangeType: Changed
File: c:\foo\log1.log ChangeType: Changed
File: c:\foo\log1.log ChangeType: Changed
File: c:\foo\log1.log ChangeType: Changed

このような出力が表示されない場合は、ログの書き込み時にアプリケーションまたはサービスの問題が生じているか、Kinesis Agent for Windows の問題ではなく、セキュリティ設定の問題が存在します。このような出力が表示されているにもかかわらず、Windows 用 Kinesis Agent がログを処理していないように思われる場合は、」デスクトップまたはサーバーから予想される AWS のサービスにデータがストリーミングされない。

ログがごくまれにしか書き込まれない場合でも、Windows の Kinesis エージェントが正しく機能していることを確認するのに役立ちます。たとえば、以下のように、/log4net スイッチを使用して、Log4net ライブラリを使用してログを書き込むアプリケーションをシミュレートします。

cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
KTDiag.exe /log4net c:\foo\log2.log

これによって、Log4net スタイルのログファイルが c:\foo\log2.log ログファイルに書き込まれ、キーが押されるまで新しいログエントリが追加され続きます。ファイル名の後に任意で指定される追加のスイッチを使用して、複数のオプションを設定できます。

Windows イベントログに書き込むアプリケーションをシミュレートすると役に立つ場合があります。以下のように、/e スイッチを使用して、Windows イベントログにログエントリを書き込みます。

cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
KTDiag.exe /e Application

これによって、キーが押されるまで、ログエントリが Windows アプリケーションイベントログに書き込まれます。ログの名前の後に以下の追加オプションを任意で指定できます。