{"id":20621067,"url":"https://github.com/mmcquillan/lawsg","last_synced_at":"2025-04-15T12:14:59.009Z","repository":{"id":57550737,"uuid":"109037784","full_name":"mmcquillan/lawsg","owner":"mmcquillan","description":"The AWS Cloudwatch Log Viewer","archived":false,"fork":false,"pushed_at":"2023-06-10T01:28:54.000Z","size":975,"stargazers_count":34,"open_issues_count":4,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-15T12:14:52.938Z","etag":null,"topics":["aws","cli","cloudwatch","golang","logs"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mmcquillan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-31T18:37:14.000Z","updated_at":"2024-04-12T10:17:46.000Z","dependencies_parsed_at":"2024-06-20T04:38:40.299Z","dependency_job_id":"02fab8d6-cf20-4405-bfaa-481b4a42a97f","html_url":"https://github.com/mmcquillan/lawsg","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmcquillan%2Flawsg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmcquillan%2Flawsg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmcquillan%2Flawsg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmcquillan%2Flawsg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mmcquillan","download_url":"https://codeload.github.com/mmcquillan/lawsg/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249067779,"owners_count":21207396,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cli","cloudwatch","golang","logs"],"created_at":"2024-11-16T12:16:32.354Z","updated_at":"2025-04-15T12:14:58.992Z","avatar_url":"https://github.com/mmcquillan.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# lawsg - The AWS Cloudwatch Logs Viewer\n\n### Why another cloudwatch CLI?\n- Query one or more Cloudwatch groups\n- Advanced formatting to help you find what you need\n- Highlight keywords in Green, Yellow or Red to capture your attention\n- Display preferences via command line flags, env variables or a config file\n- Help for when you can't quite remember the group name\n\n\n### Get Started\n1. Install on Mac via brew: `brew install mmcquillan/tools/lawsg`\n2. Alternatively compile via go: `go get github.com/mmcquillan/lawsg`\n3. Ensure you set your AWS Environment Variables:\n    - `AWS_REGION`\n    - `AWS_ACCESS_KEY_ID`\n    - `AWS_SECRET_ACCESS_KEY`\n4. Get started with: `lawsg help more`\n5. Enjoy all your wonderful logs!\n\n\n### Features\n```\nUSAGE:\n  lawsg help [ more | \u003ctopic name\u003e ]\n  lawsg groups [options]\n  lawsg streams \u003cgroup name\u003e [options]\n  lawsg get \u003cgroup name\u003e [options]\n  lawsg version\n\nFILTER OPTIONS:\n  -f --filter         Cloudwatch Filter for Event Logs\n  -m --stream         Comma delimited list of Streams\n  -s --starttime      Start Time for the Event Logs [default: 10 min before now]\n  -e --endtime        End Time for the Event Logs [default: now]\n  -n --number         Number of Log Events to show\n  -t --tail           Active tailing of Event Logs\n\nDISPLAY OPTIONS:\n     --tz             Convert Event Log display to local time\n     --spacing        Adds spacing between Log Events\n     --ng             Display No Group column\n     --ns             Display No Stream column\n     --nt             Display No Time column\n     --nc             Display No Color\n     --nw             Display No Wrapping of lines (truncates)\n     --stream-ltrim   Trims Left side of Stream Name\n     --stream-rtrim   Trims Right side of Stream Name\n     --message-ltrim  Trims Left side of Event Message\n     --message-rtrim  Trims Right side of Event Message\n     --multi-line     Handles multiple logs entries in one Event Message\n     --green          Comma delimited Words to highlight Green\n     --yellow         Comma delimited Words to highlight Yellow\n     --red            Comma delimited Words to highlight Red\n\nADVANCED OPTIONS:\n  -c --command        Command to run groups, streams, get, help (or first argument)\n  -g --group          Group for the command (or second argument)\n     --chunk          Chunk size for retrieving Event Logs [default: 10000]\n     --sortkey        Add each line with a sortable time based key [default: false]\n     --refresh        Tail Refresh interval in seconds [default: 5]\n     --region         Override or set the AWS Region\n     --env            Environment prefix multiple AWS ENV Vars (ex: STAGING_AWS_REGION)\n     --stats          Display Stats from request\n     --debug          Debug of Output\n```\n[More Detailed Features and Help...](HELP.md)\n\n\n### Releases\n\nv0.3.0\n- Added `--env` var for multiple AWS ENV vars\n- Added `--region` var for overriding or setting the AWS region\n- Added messaging if Start Time is parsed incorrectly\n- Added `--sortkey` to prefix each line with the epoch timestamp for sorting\n\nv0.2.0\n- Added get for multiple or all log groups\n- Added a countdown before update on the tail option\n\nv0.1.1\n- Added the multi-line formatting option to handle multiple log entries per Event Message\n- Fixed a help issue\n\nv0.1.0\n- Initial release\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmcquillan%2Flawsg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmmcquillan%2Flawsg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmcquillan%2Flawsg/lists"}