lumigo-io / lambda-log-shipper

Ship your AWS lambda logs anywhere. The no-code style.

• Usage
• Advanced Configuration
• How it works
• Contribute

Usage

Add the layer to your lambda (read how):
LAYER_ARN=arn:aws:lambda:<region>:114300393969:layer:lumigo-log-shipper:3.

Choose a shipping method:

• S3 - Set the environment variable LUMIGO_EXTENSION_LOG_S3_BUCKET to your target bucket. Don't forget to add proper permissions.

Please contribute or open us a ticket for more integrations.

Advanced Configuration

(Optional) Choose shipping parameters:

• LUMIGO_EXTENSION_LOG_BATCH_SIZE (default 1000) indicates the target size (in bytes) of each log file. We will aggregate logs to at least this size before shipping.
• LUMIGO_EXTENSION_LOG_BATCH_TIME (default 60000) indicates the target time (in milliseconds) before closing a log file. We will aggregate logs for at least this period before shipping.

Note: We will ship the logs immediately when the container is shutting down. Therefore, log files can be smaller and more frequent than the above configuration.

How it works

We use the new extensions feature to trigger a new process that handles your logs. This process is triggered by the LambdaService with the lambda's logs, which being aggregated in-memory and transferred to your chosen shipping method.

Contribute

Our extension is written in python3.7, and our test environment is pytest and moto to test interaction AWS services.

To add another log-shipping method, open a PR with 4 file changes:

1. src/lambda_log_shipper/handlers/your_new_handler.py - Contains a class that extends LogsHandler, and implements the method: def handle_logs(self, records: List[LogRecord]) -> bool
2. test/lambda_log_shipper/handlers/test_your_new_handler.py - Contains your tests
3. Update the file src/lambda_log_shipper/handlers/__init__.py With an import to your class
4. src/lambda_log_shipper/configuration.py - Contains your new configuration properties.

You can run the tests with ./scripts/checks.sh, which also checks linting and code convensions.

You can upload a private version of the extension with ./scripts/deploy.sh for local testing. This script will output the ARN of your local layer.