Skip to main content
https://img.shields.io/pypi/v/s3logs.svg?style=flat-square https://img.shields.io/pypi/dm/s3logs.svg?style=flat-square

Get files from directory by mask and push them to S3

Install

pip install s3logs

Usage

s3logs config.conf

Where config.conf can use that structure:

[S3]
access_key = <S3_KEY>
secret_key = <S3_SECRET_KEY>
host = <s3.example.com>
bucket = <bucket_name>
chunk_size = <bytes, default=52428800>

[logs]

suffix = .0.gz
key_suffix = .gz
directory = /var/log/nginx/
filename = <filename, default=(yesterday as yyyy-mm-dd)>

[map]

example.com-access.log = example/access
example.com-error.log = example/error
mysite.me.access.log = mysite/access

When it used with that config, script takes all files in directory /var/log/nginx/, filter only those, which ends with .0.gz and send it to S3, according to map.

For example, /var/log/nginx now consists of:

example.com-access.log
example.com-access.log.0.gz
example.com-access.log.1.gz
example.com-error.log
example.com-error.log.0.gz
example.com-error.log.1.gz
mysite.me.access.log
mysite.me.access.log.0.gz
mysite.me.error.log
mysite.me.error.log.0.gz

So, if today is 9 December 2015, and your hostname is node1, on your S3 <bucket_name> would be those keys:

node1/example/access/2015-12-09.gz
node1/example/error/2015-12-09.gz
node1/mysite/access/2015-12-09.gz

Because we have not explain how maps mysite.me.error.log.0.gz - it would be skipped.

If there was filename=newfile option in config.conf, keys in S3 would look like node1/example/access/newfile.gz

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

s3logs-1.2.tar.gz (3.3 kB view details)

Uploaded Source

File details

Details for the file s3logs-1.2.tar.gz.

File metadata

  • Download URL: s3logs-1.2.tar.gz
  • Upload date:
  • Size: 3.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for s3logs-1.2.tar.gz
Algorithm Hash digest
SHA256 a25a6d76ca3d8e3a585805452b73fdb04d19effa982a19d2adf0a0cfcfb2e27b
MD5 294f9f9a0ef9634ff490329d83ccb2a5
BLAKE2b-256 f75ac56124b911ea2566af1df1afd35248a60feea4d17ee16e0d89cd818633a6

See more details on using hashes here.

Release history Release notifications | RSS feed

1.8

1 file

1.7

1 file

1.6

2 files

1.5

2 files

1.4

2 files

1.3

1 file

This release

1.2 This release

1 file

1.1

1 file

1.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page