{"id":19481772,"url":"https://github.com/apex/logs-cloudwatch","last_synced_at":"2026-02-27T11:43:41.101Z","repository":{"id":57538661,"uuid":"287518094","full_name":"apex/logs-cloudwatch","owner":"apex","description":"Send your AWS CloudWatch Logs to Apex Logs.","archived":false,"fork":false,"pushed_at":"2020-08-14T12:18:45.000Z","size":12,"stargazers_count":38,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-25T15:39:57.551Z","etag":null,"topics":["apex-logs","aws","cloudwatch-logs","integration","logging"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apex.png","metadata":{"files":{"readme":"Readme.md","changelog":"History.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-14T11:33:18.000Z","updated_at":"2024-08-02T02:22:26.000Z","dependencies_parsed_at":"2022-09-19T07:30:35.392Z","dependency_job_id":null,"html_url":"https://github.com/apex/logs-cloudwatch","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/apex/logs-cloudwatch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apex%2Flogs-cloudwatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apex%2Flogs-cloudwatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apex%2Flogs-cloudwatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apex%2Flogs-cloudwatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apex","download_url":"https://codeload.github.com/apex/logs-cloudwatch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apex%2Flogs-cloudwatch/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265509369,"owners_count":23779343,"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":["apex-logs","aws","cloudwatch-logs","integration","logging"],"created_at":"2024-11-10T20:06:30.867Z","updated_at":"2026-02-27T11:43:36.081Z","avatar_url":"https://github.com/apex.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# CloudWatch → Apex Logs \n\nThe `logs-cloudwatch` command-line tool provides an easy way to send AWS CloudWatch Logs to [Apex Logs](https://apex.sh/logs/).\n\n## Installation\n\n```\n$ curl -sf https://gobinaries.com/apex/logs-cloudwatch | sh\n```\n\n## Usage\n\nCommand usage:\n\n```\nlogs-cloudwatch\n\n  Flags: \n       --version      Displays the program version string.\n    -h --help         Displays help with available flag, subcommand, and positional value parameters.\n       --project-id   Apex Logs destination project ID\n       --auth-token   Apex Logs authentication token\n       --endpoint     Apex Logs integration endpoint URL\n       --region       AWS region id\n       --stack-name   AWS CloudFormation stack name (default: ApexLogs)\n       --exclude      AWS CloudWatch log group filters\n       --include      AWS CloudWatch log group filters\n       --confirm      Confirm creation of the stack (default: false)\n       --template     Output the template and exit\n\n```\n\n## Example\n\nProvide your Apex Logs destination project ID, API endpoint (with `/integrations/cloudwatch` as the path), and API token to provide AWS write-access to your logs. For help creating an API token visit the [Apex Logs documentation](https://apex.sh/docs/logs/api/#authentication).\n\n```\nlogs-cloudwatch \\\n  --project-id \u003cproject-id\u003e \\\n  --endpoint https://\u003cendpoint\u003e/integrations/cloudwatch \\\n  --auth-token \u003capi-token\u003e \\\n  --include /aws/lambda/ \\\n  --region us-west-2\n```\n\nOmitting the `--confirm` flag will output a preview of the matching log groups:\n\n```\n==\u003e Finding log groups\n==\u003e Found 4 matching log groups:\n\n    /aws/lambda/logs-api\n    /aws/lambda/news-api\n    /aws/lambda/primary-api\n    /aws/lambda/up-api\n\n==\u003e Run command again with --confirm to create the stack\n```\n\nTweak your `--include` and `--exclude` filters as necessary to get the log groups you want, then add the `--confirm` flag to generate the stack.\n\n## Filtering\n\nRunning `logs-cloudwatch` without `--include` or `--exclude` flags will subscribe to all log groups. The filter patterns are simply sub-string matches, for example `get_` would match `/aws/lambda/get_team_members`, and `API` would match `API-Gateway-Execution-Logs_g2sdfdwn5rkc6/production`.\n\n### Examples\n\nSend all logs:\n\n```sh\n$ logs-cloudwatch\n```\n\nInclude only AWS Lambda logs, matching groups such as `/aws/lambda/get_team_members`:\n\n```sh\n$ logs-cloudwatch --include /aws/lambda/\n```\n\nInclude only AWS Lambda logs, matching groups such as `/aws/lambda/get_team_members`, but excluding a few.\n\n```sh\n$ logs-cloudwatch --include /aws/lambda/ --exclude /aws/lambda/api,/aws/lambda/app\n```\n\nExclude RDS and API Gateway logs:\n\n```sh\n$ logs-cloudwatch --exclude API-Gateway,RDS\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapex%2Flogs-cloudwatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapex%2Flogs-cloudwatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapex%2Flogs-cloudwatch/lists"}