{"id":13413832,"url":"https://github.com/blind-oracle/riemann-relay","last_synced_at":"2026-05-16T01:33:40.281Z","repository":{"id":57496918,"uuid":"183030519","full_name":"blind-oracle/riemann-relay","owner":"blind-oracle","description":"Service for relaying Riemann events to Riemann/Carbon destinations","archived":false,"fork":false,"pushed_at":"2019-10-29T15:00:14.000Z","size":126,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-02T16:58:37.145Z","etag":null,"topics":["balance","carbon","go","golang","json","load","protobuf","relay","riemann"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blind-oracle.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":"2019-04-23T14:17:12.000Z","updated_at":"2022-09-27T09:23:35.000Z","dependencies_parsed_at":"2022-09-03T02:00:13.440Z","dependency_job_id":null,"html_url":"https://github.com/blind-oracle/riemann-relay","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/blind-oracle/riemann-relay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blind-oracle%2Friemann-relay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blind-oracle%2Friemann-relay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blind-oracle%2Friemann-relay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blind-oracle%2Friemann-relay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blind-oracle","download_url":"https://codeload.github.com/blind-oracle/riemann-relay/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blind-oracle%2Friemann-relay/sbom","scorecard":{"id":243395,"data":{"date":"2025-08-11","repo":{"name":"github.com/blind-oracle/riemann-relay","commit":"2bc2ebacaf1897c0a9ec1ba0f5a3f7513a6f2d44"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.7,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Mozilla Public License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.0.0 not signed: https://api.github.com/repos/blind-oracle/riemann-relay/releases/17075656","Warn: release artifact v1.0.0 does not have provenance: https://api.github.com/repos/blind-oracle/riemann-relay/releases/17075656"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}}]},"last_synced_at":"2025-08-17T07:02:58.805Z","repository_id":57496918,"created_at":"2025-08-17T07:02:58.805Z","updated_at":"2025-08-17T07:02:58.805Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33087028,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["balance","carbon","go","golang","json","load","protobuf","relay","riemann"],"created_at":"2024-07-30T20:01:50.646Z","updated_at":"2026-05-16T01:33:40.261Z","avatar_url":"https://github.com/blind-oracle.png","language":"Go","funding_links":[],"categories":["Server Applications","服务器应用程序","服务端应用","Relational Databases"],"sub_categories":["HTTP Clients","HTTP客户端","查询语"],"readme":"[![Go Report Card](https://goreportcard.com/badge/github.com/blind-oracle/riemann-relay)](https://goreportcard.com/report/github.com/blind-oracle/riemann-relay)\n[![Coverage Status](https://coveralls.io/repos/github/blind-oracle/riemann-relay/badge.svg?branch=master)](https://coveralls.io/github/blind-oracle/riemann-relay?branch=master)\n[![Build Status](https://travis-ci.org/blind-oracle/riemann-relay.svg?branch=master)](https://travis-ci.org/blind-oracle/riemann-relay)\n[![Mentioned in Awesome Go](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/avelino/awesome-go)\n\n# riemann-relay\nThis is a service that receives a Riemann Protobuf-formatted event stream and sends it to one or more targets in Riemann or Graphite format.\nAlthough that can be done in Riemann itself, this service is simpler, probably faster and lightweight (no Java)\n\n## Features\n* Receive event batches in Riemann Protobuf format (see *riemann.proto*)\n* Receive events in Riemann JSON format using Websocket API\n* Convert Riemann events to Carbon metrics using flexible field mapping syntax\n* Send events in configurable batch sizes to any number of Riemann/Carbon targets\n* Supports TCP and Unix Sockets\n* Different target selection algorithms:\n  - Round-Robin\n  - Hash\n  - Failover\n  - Broadcast\n* Optional failover to other targets if the selected one is down (in Hash and Round-Robin modes)\n* Prometheus metrics\n* Log stats periodically\n* Configurable batch and buffer sizes, flush intervals, timeouts\n* Build RPM and DEB packages\n\nSee *riemann-relay.conf* for more details on features and how to configure them\n\n## Performance\nOn 2 average CPU cores it's able to handle about 500k events per second, depending on batch size and incoming Riemann message sizes.\nIt will scale to more CPUs when using more targets and clients (each target and client gets it's own thread).\nThere's a room for optimizations, though.\n\n## JSON URI and Event structure for Websocket\nURI: ws://1.1.1.1:1234/events\n\n```json\n{\n    \"host\": \"host1\",\n    \"service\": \"svc1\",\n    \"description\": \"cool\",\n    \"state\": \"ok\",\n    \"tags\": [\"tag1\", \"tag2\"],\n    \"metric\": 123,\n    \"time\": \"2018-04-10T13:36:04.787Z\",\n    \"attributes\": [\n        {\n            \"key\": \"key1\",\n            \"value\": \"val1\"\n        }\n    ]\n}\n```\n\n## Install\nFor now in the releases only binaries for *linux-amd64* are available. For other platforms see the *Build* section below.\n\n## Build\n**riemann-relay** is written in [Go](https://golang.org/) and uses [dep](https://github.com/golang/dep) as a dependency manager, so you need to install them first.\n\nThen:\n```bash\n# dep ensure\n# go build\n```\n\n## Packaging\nTo build RPM \u0026 DEB packages you'll need [gox](https://github.com/mitchellh/gox) and [fpm](https://github.com/jordansissel/fpm).\n\nThen just do one of:\n```bash\n# make rpm\n# make deb\n```\n\n## Run\n```bash\n# /path/to/riemann-relay -config /etc/riemann-relay.conf\n```\n\nThe logging currently goes to stdout.\nUse *-debug* option to get a lot more detailed output (not for production).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblind-oracle%2Friemann-relay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblind-oracle%2Friemann-relay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblind-oracle%2Friemann-relay/lists"}