Contents

# fluent-plugin-s3-input
Fluentd plugin that will read a json file from S3.  This plugin can be used to
handle S3 Event Notifications such as cloudtrail API logs

# Usage

S3 Event Example Intake 

	# Get Notified of JSON document in S3
	<source>
	  type sqs
	  tag sqs.s3.event
	  sqs_url SQS_S3_NOTFICATION_QUEUE
	  receive_interval 1
	  max_number_of_messages 10
	  wait_time_seconds 20
	</source>

	# Remove SQS encapsulation
	<filter sqs.s3.events>
	  type parser
	  format json
	  key_name body
	</filter>

	# Transform to Array
	<match sqs.s3.events>
	  type record_splitter
	  split_key Records
	  tag sqs.s3.event
	</match>

	# extract s3_path
	<filter sqs.s3.event>
	  @type record_transformer
	  enable_ruby
	  renew_record true
	  <record>
            s3_bucket ${record['s3']['object']['key']}
	    s3_key ${record['s3']['bucket']['name']}
	  </record>
	</filter>
	
	# read and emit the json object
	# this plugin!
	<match sqs.s3.event>
	  type s3_input
	  merge_record no
	  s3_bucket_key s3_bucket
	  s3_object_key_key s3_object
	  uncompress gzip
	  tag s3.file.contents
	</filter>

	# Emit each record in the cloudtrail json document as a new event
	<match s3.file.contents>
	  type record_splitter
	  split_key Records
	  tag cloudtrail
	</match>
# params
    tag my.new.tag : tag name to emit new record as
    uncompress gzip : decompression algorithm (only gzip:-/)
    s3_bucket_key my_s3_bucket : The name of your S3 bucket
    s3_object_key_key /some/cool/object : The path to your S3 object
    merge_record  yes|no : Do we merge or replace the input record
    remove_keys key1, key2 : keys that we remove after reading the s3 object
    compression_exts gz, zip : extensions that we uncompress.  Allows you to ingest both compressed and uncompressed files
    record_key : if set, the record will be placed in this key 
    aws_region : region to use.  Default to us-east-1

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
fluent-plugin-s3-input-0.0.15	README.md
fluent-plugin-s3-input-0.0.14	README.md
fluent-plugin-s3-input-0.0.13	README.md
fluent-plugin-s3-input-0.0.12	README.md