aws-logging-handlers

What it is and what it does

aws-logging-handlers is a Python logging handler that routes log records directly to AWS services—specifically S3 and Kinesis—using multithreaded asynchronous uploads. It integrates with Python's standard logging module, allowing you to attach S3Handler or KinesisHandler instances to your logger and have records streamed to AWS in the background. For S3, it supports automatic log rotation based on size or time interval, with optional gzip compression.

The package is designed for applications that need centralized log aggregation in AWS without intermediate processing. It handles the threading and multipart upload mechanics internally. However, the project has been abandoned with last commit on 2022-05-03, and it declares no explicit runtime dependencies in its metadata despite requiring boto3, creating uncertainty about compatibility with current AWS SDK versions and modern Python runtimes.

Use it for:

• Stream application logs directly to S3 for long-term archival with automatic rotation and compression.
• Send real-time log events to Kinesis for downstream processing or analytics pipelines.
• Centralize logs from multithreaded Python applications to AWS without external log aggregation services.
• Rotate and archive logs to S3 based on size or time thresholds in background threads.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Routes Python logging records to AWS S3 and Kinesis using multithreaded handlers with optional gzip compression for S3.

No. The project is abandoned (last commit 2022-05-03), classifiers list only Python up to 3.7, and it declares no runtime dependencies despite requiring boto3—creating maintenance and compatibility risk. High install friction and lack of modern AWS SDK support make it unsuitable for new projects.

Install

aws-logging-handlers on PyPI

pip install aws-logging-handlers

uv add aws-logging-handlers

poetry add aws-logging-handlers

Installing aws-logging-handlers

Before you install

High install friction due to no runtime dependencies declared in the package metadata, though boto3 is required per documentation. Project is abandoned with last commit on 2022-05-03 and no updates for 2083 days since release.

License in practice

Licensed under MIT (permissive), allowing use in most commercial and open-source contexts without significant restriction.

Quickstart

pip install aws-logging-handlers

import logging
from aws_logging_handlers.S3 import S3Handler

s3_handler = S3Handler("test_log", "my_bucket", workers=3)
logger = logging.getLogger('root')
logger.addHandler(s3_handler)
logger.info("message to s3")

boto3 must be installed separately; AWS credentials and permissions for S3 or Kinesis are required; multithreading support is assumed available.

Verify before relying

• Whether the package works with modern Python versions (classifiers list only up to 3.7; current support unknown)
• Whether boto3 is automatically installed as a dependency or must be manually added
• Whether the package is compatible with current AWS SDK versions
• Status of any known issues or breaking changes since the last 2020-11-30 release

Package facts

Evidence: aws-logging-handlers-2.0.5.tar.gz

Keywords: logging, s3, aws, handler, amazon, stream, kinesis, firehose

Tags

More Monitoring packages