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.

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page