Skip to main content

AWS CloudWatch Logs Insights is wrapped by Python

Project description


PyPI - Python Version PyPI GitHub

A CLI tool To query CloudWatch Logs Insights.





Write Configuration

Write configuration to pyinsights.yml like:

version: '1.0'
  - '/ecs/sample'
query_string: 'field @message | filter @message like /ERROR/'
duration: '30m'
limit: 10

I wrote examples, so see examples folder.

Execute command

pyinsights -c pyinsights.yml -p aws_profile -r region


Parameter Type Required Description
version string true Choose configuration version from ['1.0']
log_group_name array true Target log group names to query
query_string string true Pattern to query
duration string or object true
string Specify hours, minutes or seconds from now
hours = h,
minutes = m,
seconds = s,
days = d,
weeks = w
object Specify start_time and end_time
Datetime format must be YYYY-MM-DD HH:MM:SS
limit integer false The number of log to fetch

CLI Options

Option Required Description
-c, --config true Specify yaml configuration by absolute or relative path
-f, --format false Choose from json or table
-p, --profile false AWS profile name
-r, --region false AWS region
-v, --version false Show version

Environment Variable

If profile and region options are not specified, AWS Credentials must be set as environment variables.


Please see Environment Variable Configuration for the detail.

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 pyinsights, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size pyinsights-0.3.0-py3-none-any.whl (10.3 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size pyinsights-0.3.0.tar.gz (9.4 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 DigiCert DigiCert EV certificate StatusPage StatusPage Status page