Skip to main content

Ship logs to Lumigo platform

Project description

CircleCI codecov Version


Lumigo Log Shipper API lets you stream your Lambda functions' logs to Lumigo as a part of your custom log shipping function.

NOTE: Lumigo will automatically try to subscribe your Lambda functions to a Kinesis data stream. In case your log group is already subscribed to a Lambda as a destination, use this library to send logs to Lumigo.

Please contact Lumigo's support through the platform chat so we can enable this feature for you.


Install lumigo-log-shipper:


> pip install lumigo-log-shipper

In your log shipping Lambda's code:

from lumigo_log_shipper import lumigo_shipper

def handler(event, context):

If you are using programmatic errors, add your custom error keyword as an additional parameter. This will also send logs which contains your custom expression for Lumigo to process.

from lumigo_log_shipper import lumigo_shipper

def handler(event, context):
    lumigo_shipper.ship_logs(event, ["WARNING-EXAMPLE"])

Add to your lambda's serverless.yml

    - Effect: Allow
        - "firehose:PutRecordBatch"
        - "arn:aws:firehose:[YOUR-REGION]:114300393969:deliverystream/prod_logs-edge-stfl_customer-logs-firehose"
    - Effect: Allow
        - "sts:AssumeRole"
        - "arn:aws:iam::114300393969:role/prod-CustomerLogsWriteRole"

Project details

Download files

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

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

lumigo_log_shipper-1.0.29-py3-none-any.whl (13.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page