# jorgebastida/awslogs

AWS CloudWatch logs for Humans™

Repository: https://github.com/jorgebastida/awslogs
Canonical: https://ross.abutalabs.com/products/awslogs
Language: Python
License: NOASSERTION
License Family: other
Last push: 2024-05-17T01:57:44+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4242, "days_push": 839, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4988, forks 342 (observed 2026-08-28T04:09:04.275903+00:00)

## What it is
awslogs is a Python command-line tool for querying log groups, streams, and events from Amazon CloudWatch Logs. It aggregates events across streams with human-friendly time filtering, colored output, and pseudo-realtime watching that pipes well into tools like grep.

## Use cases
- tail cloudwatch logs from the terminal
- grep errors across multiple cloudwatch log streams
- list cloudwatch log groups and streams
- filter cloudwatch events by time range like '2h ago'
- watch new cloudwatch log events in realtime

## When to choose
- you want a fast terminal-based alternative to the AWS console for CloudWatch Logs
- you need to aggregate and filter logs across many streams with unix pipes
- you prefer human-friendly time filters over raw timestamps

## When to avoid
- you need a GUI or dashboard for log analysis
- you use a cloud provider other than AWS
- you need long-term log storage or alerting rather than querying

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, logging, search-engine
- domain: cloud-computing, developer-tools, monitoring
- platform: cli, python, cross-platform
- tags: aws, cloudwatch, log-viewer, log-aggregation, command-line

## Member repositories
- jorgebastida/awslogs (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:04.275903+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:17:40.357316+00:00, confidence not recorded.
  - readme: https://github.com/jorgebastida/awslogs (fetched 2026-08-28T04:09:04.275903+00:00, sha 5309fa1cad79)
  - registry_pypi: https://pypi.org/pypi/awslogs/json (fetched 2026-08-29T08:58:42.052062+00:00, sha 94ba7acce4e4)
- Data as of 2026-08-30T08:39:29.467469+00:00.