awslogs

{
  "aliases": [],
  "alternatives": [],
  "build_dependencies": [],
  "categories": [],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [
    "python@3.14"
  ],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Simple command-line tool to read AWS CloudWatch logs",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:35:42+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "awslogs",
  "github_default_branch": "master",
  "github_last_commit_at": "2024-05-17T01:57:44Z",
  "github_readme_excerpt": "awslogs\n=======\n\n.. image:: https://badge.fury.io/py/awslogs.png\n  :target: http://badge.fury.io/py/awslogs\n\n.. image:: https://coveralls.io/repos/jorgebastida/awslogs/badge.svg\n  :target: https://coveralls.io/r/jorgebastida/awslogs\n\n\n``awslogs`` is a simple command line tool for querying groups, streams and events from `Amazon CloudWatch \u003chttp://aws.amazon.com/cloudwatch/\u003e`_ logs.\n\nOne of the most powerful features is to query events from several streams and consume them (ordered) in pseudo-realtime using your favourite tools such as ``grep``::\n\n    $ awslogs get /var/log/syslog ip-10-1.* --start=\u00272h ago\u0027 | grep ERROR\n\n\nFeatures\n--------\n\n* Aggregate logs from across streams.\n\n  - Aggregate all streams in a group.\n  - Aggregate streams matching a regular expression.\n\n* Colored output.\n* List existing groups\n\n  - ``$ awslogs groups``\n\n* List existing streams\n\n  - ``$ awslogs streams /var/log/syslog``\n\n* Watch logs as they are created\n\n  - ``$ awslogs get /var/log/syslog ALL --watch``\n\n* Human-friendly time filtering:\n\n  - ``--start=\u002723/1/2015 14:23\u0027``\n  - ``--start=\u00272h ago\u0027``\n  - ``--start=\u00272d ago\u0027``\n  - ``--start=\u00272w ago\u0027``\n  - ``--start=\u00272d ago\u0027 --end=\u00271h ago\u0027``\n\n* Retrieve event metadata:\n\n  - ``--timestamp`` Prints the creation timestamp of each event.\n  - ``--ingestion-time`` Prints the ingestion time of each event.\n\n\nExample\n-------\n\nRunning: ``awslogs get /var/logs/syslog ALL -s1d`` will return you events from any ``stream`` in the ``/var/logs/syslog`` group generated in the last day.\n\n.. image:: https://github.com/jorgebastida/awslogs/raw/master/media/screenshot.png\n\n\nInstallation\n------------\n\nYou can easily install ``awslogs`` using ``pip``::\n\n  $ pip install awslogs\n\nIf you are on OSX El Capitan, use the following (Why? Check Donald Stufft\u0027s comment `here \u003chttps://github.com/pypa/pip/issues/3165#issuecomment-145856429\u003e`_) ::\n\n  $ pip install awslogs --ignore-installed six\n\nYou can also install it with `brew \u003chttps://brew.sh/\u003e`_::\n\n  $ brew install awslogs",
  "github_repo": "jorgebastida/awslogs",
  "github_stars": 4988,
  "github_topics": [],
  "homepage": "https://github.com/jorgebastida/awslogs",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 187,
  "installs_365d": 2942,
  "installs_90d": 607,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "BSD-3-Clause",
  "llm_generated_at": null,
  "llm_model": null,
  "name": "awslogs",
  "oldnames": [],
  "one_liner": null,
  "optional_dependencies": [],
  "rank_30d": 2689,
  "rank_365d": 2420,
  "rank_90d": 2680,
  "raw_hash": "1a05422446577d93",
  "recommended_dependencies": [],
  "revision": 5,
  "ruby_source_path": "Formula/a/awslogs.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": "HEAD",
  "version_stable": "0.15.0",
  "versioned_formulae": [],
  "why_use_this": null
}