{"id":20589978,"url":"https://github.com/doist/cloudwatchlogs-relay","last_synced_at":"2026-04-21T14:31:07.083Z","repository":{"id":44656793,"uuid":"241440255","full_name":"Doist/cloudwatchlogs-relay","owner":"Doist","description":"rsyslogd helper that forwards messages to CloudWatch Logs","archived":false,"fork":false,"pushed_at":"2023-02-14T15:55:47.000Z","size":10,"stargazers_count":1,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-16T23:43:31.014Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://pkg.go.dev/github.com/doist/cloudwatchlogs-relay","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/Doist.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"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":"2020-02-18T18:46:34.000Z","updated_at":"2020-04-21T01:03:35.000Z","dependencies_parsed_at":"2024-06-20T00:05:46.815Z","dependency_job_id":null,"html_url":"https://github.com/Doist/cloudwatchlogs-relay","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Doist%2Fcloudwatchlogs-relay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Doist%2Fcloudwatchlogs-relay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Doist%2Fcloudwatchlogs-relay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Doist%2Fcloudwatchlogs-relay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Doist","download_url":"https://codeload.github.com/Doist/cloudwatchlogs-relay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242218824,"owners_count":20091498,"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":[],"created_at":"2024-11-16T07:33:15.506Z","updated_at":"2026-04-21T14:31:07.043Z","avatar_url":"https://github.com/Doist.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"Program cloudwatchlogs-relay listens for rsyslogd messages over unix socket\nand sends messages to CloudWatch logs.\n\nTo send all logged messages on a host to CloudWatch Logs, configure rsyslogd\nby creating file /etc/rsyslog.d/cloudwatch.conf with the following content:\n\n    $ModLoad omuxsock\n    $OMUxSockSocket /var/run/cloudwatch\n    *.* :omuxsock:\n\nRestart rsyslogd, and run this program like this:\n\n    cloudwatchlogs-relay -socket=/var/run/cloudwatch \\\n        -group=/groupname/rsyslogd \\\n        -stream='instance/${INSTANCE_ID}'\n\nThis will create log group \"/groupname/rsyslogd\", and inside it a log stream\n\"instance/${INSTANCE_ID}\", where ${INSTANCE_ID} would be replaced with EC2\ninstance ID. Supported placeholders for replacement are: ${HOSTNAME},\n${INSTANCE_ID}, ${RANDOM} — for instance ID, hostname, and random string. Be\ncareful to make sure placeholders are not expanded by the shell (use single\nquotes).\n\nProgram requires the following IAM permissions:\n\n    {\n        \"Version\": \"2012-10-17\",\n        \"Statement\": [\n            {\n                \"Effect\": \"Allow\",\n                \"Action\": [\n                    \"logs:CreateLogGroup\",\n                    \"logs:CreateLogStream\",\n                    \"logs:PutLogEvents\"\n                ],\n                \"Resource\": \"*\"\n            }\n        ]\n    }\n\nNote that while program tries to remove socket on clean shutdown, it is\nstill possible that leftover socket file may be left, preventing new\ninstance from starting.\n\nIt relies on AWS SDK and expects to find credentials/region settings in\nusual places (IAM role, environment, configuration files).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoist%2Fcloudwatchlogs-relay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdoist%2Fcloudwatchlogs-relay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoist%2Fcloudwatchlogs-relay/lists"}