Basic Configuration Structure
The basic structure of the Amazon Kinesis Agent for Microsoft Windows configuration file is a JSON document with the following template:
{ "Sources": [ ], "Sinks": [ ], "Pipes": [ ] }
-
The value of
Sourcesis one or more Source Declarations. -
The value of
Sinksis one or more Sink Declarations. -
The value of
Pipesis one or more Pipe Declarations.
For more information about the Kinesis Agent for Windows source, pipe, and sink concepts, see Amazon Kinesis Agent for Microsoft Windows Concepts.
The following example is a complete appsettings.json configuration
file that configures Kinesis Agent for Windows to stream Windows application log events to Firehose.
{ "Sources": [ { "LogName": "Application", "Id": "ApplicationLog", "SourceType": "WindowsEventLogSource" } ], "Sinks": [ { "StreamName": "ApplicationLogFirehoseStream", "Region": "us-west-2", "Id": "MyKinesisFirehoseSink", "SinkType": "KinesisFirehose" } ], "Pipes": [ { "Id": "ApplicationLogTotestKinesisFirehoseSink", "SourceRef": "ApplicationLog", "SinkRef": "MyKinesisFirehoseSink" } ] }
For information about each kind of declaration, see the following sections:
Configuration Case Sensitivity
JSON-formatted files are typically case sensitive, and you should assume that all the
keys and values in Kinesis Agent for Windows configuration files are also case sensitive. Some keys and values
in the appsettings.json configuration file are not case sensitive; for
example:
-
The value of the
Formatkey-value pair for sinks. For more information, see Sink Declarations. -
The value of the
SourceTypekey-value pair for sources, theSinkTypekey-value pair for sinks, and theTypekey-value pair for pipes and plugins. -
The value of
RecordParserkey-value pair for theDirectorySourcesource. For more information, see DirectorySource Configuration. -
The value of the
InitialPositionkey-value pair for sources. For more information, see Bookmark Configuration. -
Prefixes for variable substitutions. For more information, see Configuring Sink Variable Substitutions.