翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
パイプ宣言
を使用するパイプ宣言を使用してソースを接続します(ソース宣言を参照) をシンク (シンク宣言Microsoft Windows の Amazon Kinesis エージェントの。パイプ宣言は、JSON オブジェクトとして表されます。Kinesis Agent for Windows が起動した後、ログ、イベント、またはメトリクスは特定のパイプのソースから収集されます。その後、それらはそのパイプに関連付けられているシンクを使用してさまざまな AWS のサービスにストリーミングされます。
以下は パイプ宣言の例です。
{ "Id": "MyAppLogToCloudWatchLogs", "SourceRef": "MyAppLog", "SinkRef": "MyCloudWatchLogsSink" }
パイプの設定
すべてのパイプ宣言には、次のキーと値のペアを含めることができます。
Id
-
パイプの名前を指定します (必須)。これは、設定ファイル内で一意である必要があります。
Type
-
ログデータがソースからシンクに転送されるときにパイプによって適用される変換のタイプ (ある場合) を指定します。
RegexFilterPipe
はサポートされる唯一の値です。この値は、ログレコードの基になるテキスト表現の正規表現フィルタリングを有効にします。フィルタリングを使用すると、関連するログレコードのみをデータパイプラインの下流に送信することで、送信とストレージのコストを削減できます。このキーと値のペアはオプションです。デフォルト値では、変換は行われません。 FilterPattern
-
シンクに転送される前にソースによって収集されたログレコードをフィルタリングするために使用される
RegexFilterPipe
パイプラインの正規表現を指定します。正規表現がレコードの元のテキスト表現と一致すると、ログレコードはRegexFilterPipe
タイプのパイプで転送されます。たとえば、DirectorySource
宣言でExtractionPattern
キーと値のペアを使用するときに生成される構造化ログレコードは、RegexFilterPipe
メカニズムを使用してフィルタリングできます。これは、このメカニズムが解析前の元のテキスト表現に対して機能するためです。このキーと値のペアはオプションですが、パイプがRegexFilterPipe
タイプを指定している場合は指定する必要があります。以下は
RegexFilterPipe
パイプ宣言の例です。{ "Id": "MyAppLog2ToFirehose", "Type": "RegexFilterPipe", "SourceRef": "MyAppLog2", "SinkRef": "MyFirehose", "FilterPattern": "^(10|11),.*", "IgnoreCase": false, "Negate": false }
SourceRef
-
パイプのログ、イベント、およびメトリクスデータを収集するソースを定義するソース宣言の名前 (
Id
キーと値のペアの値) を指定します (必須)。 SinkRef
-
パイプのログ、イベント、およびメトリクスデータを受け取るシンクを定義するシンク宣言の名前 (
Id
キーと値のペアの値) を指定します (必須)。 IgnoreCase
省略可能。次の値を受け入れます
true
またはfalse
。に設定した場合true
の場合、Regexは大文字と小文字を区別しない方法でレコードに一致します。Negate
省略可能。次の値を受け入れます
true
またはfalse
。に設定した場合true
の場合、パイプはレコードをしない正規表現に一致します。
RegexFilterPipe
パイプタイプを使用した完全な設定ファイルの例については、「パイプの使用」を参照してください。
Windows メトリックパイプ用の Kinesis エージェントの設定
という名前の組み込みメトリクスソースがあります_KinesisTapMetricsSource
で、Windows 用 Kinesis エージェントに関するメトリックスを生成します。ある場合CloudWatch
シンク宣言をId
のMyCloudWatchSink
次のパイプライン宣言は Windows が生成したメトリクスをそのシンクに転送します。
{ "Id": "KinesisAgentMetricsToCloudWatch", "SourceRef": "_KinesisTapMetricsSource", "SinkRef": "MyCloudWatchSink" }
Kinesis エージェント for Windows 組み込みメトリクスソースの詳細については、」Windows 組み込みメトリクスソース Kinesis エージェント。
設定ファイルが Windows パフォーマンスカウンターメトリクスもストリーミングする場合は、Kinesis Agent for Windows メトリクスと Windows パフォーマンスカウンターメトリックの両方に同じシンクを使用するのではなく、別々のパイプとシンクを使用することをお勧めします。