Skip to main content

A handy CLI to help you gather Lambda Functions logs

Project description

AWS Lambda Log Collector

If you usually find yourself trying to debug AWS Lambda Functions and getting lost when trying to search for logs, this CLI is meant for you.

Imagine your Lambda Function had an invocation error spike during last night. Today after arriving at your company you need to troubleshoot that error spike. You usually need to open CloudWatch Logs console and start to scroll infinitely through the Log Streams, even worse if the Lambda Function has millions of invocations daily.

This CLI will help you to gather all the useful CloudWatch Logs from a Lambda Function, with a single command while you can go for your morning coffee.

Why?

Because you can search for a subset of the these logs providing a start and end time, and even better you can also provide a CloudWatch Logs Filter Pattern. Making it easier to find what you are looking for!

Usage

Usage: aws-lambda-log-collector [OPTIONS]

Options:
  --version                       Show the version and exit.
  -f, --function-name TEXT        i.e. HelloWorld  [required]
  -p, --profile TEXT              AWS profile name (i.e. dev)  [required]
  -r, --region TEXT               AWS region (i.e. eu-west-1)  [required]
  -o, --output PATH               i.e. /tmp/  [required]
  -s, --start-time TEXT           2019-10-30T12:00:00  [required]
  -e, --end-time TEXT             2019-10-31T12:00:00  [required]
  --pattern TEXT                  ERROR  [required]
  --log-level [INFO|ERROR|DEBUG]  logging level
  --help                          Show this message and exit.

Parameters

--function-name || -f

The desired Lambda Function Name you want to retrieve logs from.

--start-time || -s

The start of the time range where the CLI search for logs, CloudWatch Logs with a timestamp before this time are not returned.

Pattern: YYYY-mm-ddThh:MM:ss

--end-time || -e

The end of the time range where the CLI search for logs, CloudWatch Logs with a timestamp after this time are not returned.

Pattern: YYYY-mm-ddThh:MM:ss

--pattern

The filter pattern to use while searching for logs content. You can use CloudWatch Logs Filter and Pattern Syntax.

--output || -o

The output path where the CLI will store the logs.

--region || -r

The AWS Region where you Lambda Function belongs to.

--profile || -p

A configured aws profile.

Installation

From pip

pip install aws-lambda-log-collector

From source

git clone https://github.com/mvinii94/aws-lambda-log-collector && cd aws-lambda-log-collector

pip install -e .

Sample

aws-lambda-log-collector --function-name MyFunction \
--start-time 2019-11-10T23:30:00 --end-time 2019-11-11T03:30:00 \
--pattern "ERROR" --output /tmp/ --region eu-west-1 --profile dev

Project details


Download files

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

Files for aws-lambda-log-collector, version 0.0.7
Filename, size File type Python version Upload date Hashes
Filename, size aws_lambda_log_collector-0.0.7-py3-none-any.whl (8.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size aws-lambda-log-collector-0.0.7.tar.gz (6.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page