---
id: awslogs
version: "0.15.0"
license: BSD
license_treatment: permissive
maintenance: dormant
---

# awslogs — awslogs is a simple command line tool to read aws cloudwatch logs.

License: permissive · Maintenance: dormant · Downloads: 151.4K/mo

## What it is and what it does

awslogs is a lightweight CLI wrapper around boto3 for querying Amazon CloudWatch Logs. It lets you list log groups and streams, retrieve log events across multiple streams with time filtering, and watch logs in real-time—all from the command line. The tool supports human-friendly time syntax (e.g., '2h ago', '1d ago'), regex-based stream matching, CloudWatch filter patterns, and JSON query extraction, making it useful for ad-hoc log inspection and integration with Unix tools like grep.

The package depends on boto3, jmespath, termcolor, and python-dateutil. It requires Python 3.8 or later and AWS credentials configured through aws-cli, environment variables, or command-line arguments. The project is dormant but stable—no active development but no known vulnerabilities and a solid user base.

Use it for:

- Grep logs from multiple CloudWatch streams in the last 2 hours to find ERROR entries across a log group.
- List all log groups and streams in your AWS account without opening the AWS console.
- Watch logs in real-time as they arrive in CloudWatch using the --watch flag.
- Extract specific JSON fields from structured logs using --query to filter message content.
- Retrieve logs matching a CloudWatch filter pattern to find specific event types (e.g., Lambda REPORT lines).
- Integrate CloudWatch logs into shell scripts and CI/CD pipelines for log analysis and alerting.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

awslogs is a command-line tool for querying and streaming logs from Amazon CloudWatch, supporting log group and stream filtering, time-range queries, and real-time log watching.

Yes, if you need a lightweight CLI for CloudWatch log queries and don't require active development. The package is stable, has low install friction, and integrates well with Unix tools. The dormant maintenance status is acceptable for a mature tool with no known vulnerabilities, but expect no new features or rapid bug fixes. Use it for operational tasks and ad-hoc log inspection; avoid if you need ongoing feature development or support.

## Install

pip install awslogs
uv add awslogs
poetry add awslogs

## Installing awslogs

Before you install: Low install friction with four lightweight runtime dependencies. Maintenance is dormant (864 days since last release), though the repository remains active with 4988 stars and a recent commit in May 2024. Suitable for stable, established workflows but expect no active development.

License in practice: BSD permissive license allows use in commercial and proprietary projects with minimal restrictions.

Quickstart:

pip install awslogs

awslogs groups
awslogs get /var/log/syslog ALL --start='2h ago' | grep ERROR

Requires AWS credentials configured via aws-cli, environment variables, or command-line flags; requires CloudWatch Logs read permissions.

Verify before relying:

- Whether the package works with boto3 versions released after May 2024.
- Current compatibility with modern AWS CloudWatch API changes or new log features.

## Package facts

- License: BSD (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 151.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cloudwatch logs cli, aws logs command line, query cloudwatch streams, stream aws logs, cloudwatch log aggregation, aws log filtering tool, real-time cloudwatch logs, aws-cloudwatch, cli-tool, log-aggregation

[View on SkillFed](https://skillfed.io/packages/awslogs) · [View on PyPI](https://pypi.org/project/awslogs/)