NAME

Log::Log4perl::Appender::Chunk::Store::S3 - Store chunks in an S3 bucket

SYNOPSIS

Example:

# Built-in store class S3
log4perl.appender.Chunk.store_class=S3
# S3 Mandatory options
log4perl.appender.Chunk.store_args.bucket_name=MyLogChunks
log4perl.appender.Chunk.store_args.aws_access_key_id=YourAWSAccessKey
log4perl.appender.Chunk.store_args.aws_secret_access_key=YourAWS

See Log::Log4perl::Appender::Chunk's synopsis for a more complete example.

OPTIONS

bucket_name

Mandatory. Name of the Amazon S3 bucket to store the log chunks.

aws_access_key_id

Mandatory. Your S3 access key ID. See Net::Amazon::S3

asw_secret_acccess_key

Mandatory. Your S3 Secret access key. See Net::Amazon::S3

retry

Optional. See Net::Amazon::S3

Defaults to true.

acl_short

Optional. Shortcut to commonly used ACL rules. Valid values are: private public-read public-read-write authenticated-read.

See https://metacpan.org/source/PFIG/Net-Amazon-S3-0.59/lib/Net/Amazon/S3/Client/Object.pm

Defaults to undef, meaning your Amazon Bucket's default will be applied. That's probably the most desirable behaviour.

expires_in_days

Optional. Amount of days in the future stored chunks should expire. No value means never.

Defaults to undef.

vivify_bucket

Optional. If true, this writer will attempt to vivify a non existing bucket name if possible.

Defaults to false.

log_auth_links

Optional. If true, this writer will log (at DEBUG level) the authenticated links to the stored chunks in other log appenders.

Use with care as this could lead to confidential information leakage.

Defaults to false.

METHODS

clone

Returns a fresh copy of myself based on the same settings. Mainly used internaly.

Usage:

my $clone = $this->clone();

store

See superclass Log::Log4perl::Appender::Chunk::Store