This is an earlier version of the OpenSearch documentation. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
s3 is a source plugin that reads events from Amazon Simple Storage Service (S3) (Amazon S3) objects. The following table describes options you can use to configure the
|notification_type||Yes||String||Must be |
|compression||No||String||The compression algorithm to apply: |
|codec||Yes||Codec||The codec to apply. Must be |
|sqs||Yes||sqs||The Amazon Simple Queue Service (SQS) (Amazon SQS) configuration. See sqs for details.|
|aws||Yes||aws||The AWS configuration. See aws for details.|
|on_error||No||String||Determines how to handle errors in Amazon SQS. Can be either |
|buffer_timeout||No||Duration||The amount of time allowed for for writing events to the Data Prepper buffer before timeout occurs. Any events that the Amazon S3 source cannot write to the buffer in this time will be discarded. Default value is 10 seconds.|
|records_to_accumulate||No||Integer||The number of messages that accumulate before writing to the buffer. Default value is 100.|
|metadata_root_key||No||String||Base key for adding S3 metadata to each Event. The metadata includes the key and bucket for each S3 object. Defaults to |
The following parameters allow you to configure usage for Amazon SQS in the
s3 source plugin.
|queue_url||Yes||String||The URL of the Amazon SQS queue from which messages are received.|
|maximum_messages||No||Integer||The maximum number of messages to receive from the Amazon SQS queue in any single request. Default value is |
|visibility_timeout||No||Duration||The visibility timeout to apply to messages read from the Amazon SQS queue. This should be set to the amount of time that Data Prepper may take to read all the Amazon S3 objects in a batch. Default value is |
|wait_time||No||Duration||The amount of time to wait for long polling on the Amazon SQS API. Default value is |
|poll_delay||No||Duration||A delay to place between reading/processing a batch of Amazon SQS messages and making a subsequent request. Default value is |
|region||No||String||The AWS Region to use for credentials. Defaults to standard SDK behavior to determine the Region.|
|sts_role_arn||No||String||The AWS Security Token Service (AWS STS) role to assume for requests to Amazon SQS and Amazon S3. Defaults to null, which will use the standard SDK behavior for credentials.|
Source for flat file input.
|path||Yes||String||The path to the input file (e.g. |
|format||No||String||The format of each line in the file. Valid options are |
|record_type||No||String||The record type to store. Valid options are |
Source for reading from another pipeline.
|name||Yes||String||Name of the pipeline to read from.|
s3 processor includes the following metrics.
s3ObjectsFailed: The number of Amazon S3 objects that the
s3source failed to read.
s3ObjectsNotFound: The number of Amazon S3 objects that the
s3source failed to read due to an Amazon S3 “Not Found” error. These are also counted toward
s3ObjectsAccessDenied: The number of Amazon S3 objects that the
s3source failed to read due to an “Access Denied” or “Forbidden” error. These are also counted toward
s3ObjectsSucceeded: The number of Amazon S3 objects that the
s3source successfully read.
sqsMessagesReceived: The number of Amazon SQS messages received from the queue by the
sqsMessagesDeleted: The number of Amazon SQS messages deleted from the queue by the
sqsMessagesFailed: The number of Amazon SQS messages that the
s3source failed to parse.
s3ObjectReadTimeElapsed: Measures the amount of time the
s3source takes to perform a request to GET an S3 object, parse it, and write events to the buffer.
sqsMessageDelay: Measures the amount of time from when Amazon S3 creates an object to when it is fully parsed.
s3ObjectSizeBytes: Measures the size of Amazon S3 objects as reported by the Amazon S3
Content-Length. For compressed objects, this is the compressed size.
s3ObjectProcessedBytes: Measures the bytes processed by the
s3source for a given object. For compressed objects, this is the uncompressed size.
s3ObjectsEvents: Measures the number of events (sometimes called records) produced by an Amazon S3 object.