{"id":19330715,"url":"https://github.com/versent/syslog-cloudlogs","last_synced_at":"2025-10-23T23:19:15.583Z","repository":{"id":64304459,"uuid":"115001828","full_name":"Versent/syslog-cloudlogs","owner":"Versent","description":"This service acts as a bridge from syslog (TLS) to cloud based logging services","archived":false,"fork":false,"pushed_at":"2019-02-07T08:31:59.000Z","size":43,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-22T23:38:42.132Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/Versent/syslog-cloudlogs","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Versent.png","metadata":{"files":{"readme":"README.md","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}},"created_at":"2017-12-21T12:08:20.000Z","updated_at":"2024-09-27T11:36:55.000Z","dependencies_parsed_at":"2023-01-15T10:15:52.434Z","dependency_job_id":null,"html_url":"https://github.com/Versent/syslog-cloudlogs","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/Versent/syslog-cloudlogs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Versent%2Fsyslog-cloudlogs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Versent%2Fsyslog-cloudlogs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Versent%2Fsyslog-cloudlogs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Versent%2Fsyslog-cloudlogs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Versent","download_url":"https://codeload.github.com/Versent/syslog-cloudlogs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Versent%2Fsyslog-cloudlogs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273833236,"owners_count":25176272,"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","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-10T02:37:42.802Z","updated_at":"2025-10-23T23:19:10.551Z","avatar_url":"https://github.com/Versent.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# syslog-cloudlogs\n\nThis service acts as a bridge from syslog to cloud based logging services such as AWS cloudwatch logs and is primarily designed to enable integration of apigee logging with these services.\n\n# features\n\n* TLS+syslog listener\n* Batched upload to AWS cloudwatch logs\n* support for [AWS NLB proxy protocol v2](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html#proxy-protocol)\n\n# configuration\n\nThis is a 12 factor application and therefore requires a set of environment variables to be set, these are as follows.\n\n```\n# port which the service listens for TLS+syslog connections\nexport SYSLOG_PORT=10514\n# cloudwatch group and stream to upload logs\nexport SYSLOG_GROUP=/versent/dev/syslog\nexport SYSLOG_STREAM=apigee\n# These certs are base64 from the certs folder\nexport SYSLOG_CLIENTCACERT=XXX\nexport SYSLOG_CERT=XXX\nexport SYSLOG_KEY=XXX\n# AWS region\nexport AWS_REGION=ap-southeast-2\n# Enable proxy protocol v2 support for NLB\nexport SYSLOG_PROXY=true\n# Enable debug level logging\nexport SYSLOG_DEBUG=true\n```\n\n# Generate self-signed certificates\n\nCloudFlare's distributes [cfssl](https://github.com/cloudflare/cfssl) source code on github page and binaries on cfssl website.\n\nThis documentation assumes that you will run cfssl on your local x86_64 Linux or OSX host, that said you can download windows binaries from https://pkg.cfssl.org/.\n\n```\ncurl -s -L -o /usr/local/bin/cfssl https://pkg.cfssl.org/R1.2/cfssl_linux-amd64\ncurl -s -L -o /usr/local/bin/cfssljson https://pkg.cfssl.org/R1.2/cfssljson_linux-amd64\nchmod +x /usr/local/bin/{cfssl,cfssljson}\n```\n\nNavigate to provided CSR files provided.\n\n```\ncd certs\n```\n\nGenerate the CA certificate and private key.\n\n```\ncfssl gencert -initca ca-csr.json | cfssljson -bare ca\n```\n\nGenerate a server cert using the CSR provided.\n\n```\ncfssl gencert  \\\n    -ca=ca.pem \\\n    -ca-key=ca-key.pem \\\n    -config=ca-config.json \\\n    -hostname=localhost,127.0.0.1 \\\n    -profile=massl server-csr.json | cfssljson -bare server\n```\n\nGenerate a client cert using the CSR provided.\n\n```\ncfssl gencert \\\n  -ca=ca.pem \\\n  -ca-key=ca-key.pem \\\n  -config=ca-config.json \\\n  -profile=massl \\\n  client-csr.json | cfssljson -bare client\n```\n\n# certificates\n\nRun the following code to produce a string from a PEM encoded certificate, this can then be exported in `SYSLOG_CLIENTCACERT` environment variable.\n\n```\ncat certs/ca.pem | base64 \n```\n\nRun the following code to produce a string from a PEM encoded certificate, this can then be exported in `SYSLOG_CERT` environment variable.\n\n```\ncat certs/server.pem | base64 \n```\n\nRun the following code to produce a string from a PEM encoded key, this can then  can be exported in `SYSLOG_KEY` environment variable.\n\n```\ncat certs/server-key.pem | base64 \n```\n\n# License\n\nThis code is released under MIT License.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fversent%2Fsyslog-cloudlogs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fversent%2Fsyslog-cloudlogs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fversent%2Fsyslog-cloudlogs/lists"}