{"id":21721821,"url":"https://github.com/bgpkit/ribeye","last_synced_at":"2025-03-20T21:45:29.049Z","repository":{"id":187514130,"uuid":"675342908","full_name":"bgpkit/ribeye","owner":"bgpkit","description":"BGP RIB processing framework written in Rust","archived":false,"fork":false,"pushed_at":"2024-04-08T16:47:43.000Z","size":77,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-28T14:50:22.849Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/bgpkit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2023-08-06T15:56:05.000Z","updated_at":"2023-08-10T15:26:23.000Z","dependencies_parsed_at":"2023-12-17T05:25:49.941Z","dependency_job_id":"cccafa21-0539-4a77-a351-93b0841c04aa","html_url":"https://github.com/bgpkit/ribeye","commit_stats":null,"previous_names":["bgpkit/ribeye"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgpkit%2Fribeye","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgpkit%2Fribeye/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgpkit%2Fribeye/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgpkit%2Fribeye/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bgpkit","download_url":"https://codeload.github.com/bgpkit/ribeye/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244694319,"owners_count":20494622,"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-26T02:19:04.691Z","updated_at":"2025-03-20T21:45:29.005Z","avatar_url":"https://github.com/bgpkit.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ribeye\n\nBGP RIB processing framework written in Rust.\n\n## Processors\n\n- `peer-stats`: collector peer information from a given RIB dump file\n- `pfx2as`: prefix-to-AS mapping from a given RIB dump file\n- `as2rel`: AS-level relationship\n- `pfx2dist`: prefix-to-collector-distance mapping, counting the minimum AS-path distance for every prefix to each route\n  collector\n\n## Installation\n\n### From source\n\nCheckout the repository and run the following command to install the binary:\n\n```bash\ncargo install --path .\n```\n\n## Run\n\nGet help information:\n\n```bash\nribeye cook --help\n\nProcess recent RIB dump files\n\nUsage: ribeye cook [OPTIONS]\n\nOptions:\n      --days \u003cDAYS\u003e\n          Number of days to search back for\n          \n          [default: 1]\n\n  -e, --env \u003cENV\u003e\n          Path to environment variables file\n\n  -l, --limit \u003cLIMIT\u003e\n          limit to process the smallest N RIB dump files\n\n  -c, --collectors \u003cCOLLECTORS\u003e\n          Specify route collectors to use (e.g. route-views2, rrc00)\n\n  -p, --processors \u003cPROCESSORS\u003e\n          specify processors to use.\n          \n          Available processors: pfx2as, pfx2dist, as2rel, peer_stats\n          \n          If not specified, all processors will be used\n\n  -t, --threads \u003cTHREADS\u003e\n          Number of threads to use\n\n  -d, --dir \u003cDIR\u003e\n          Root data directory\n          \n          [default: ./results]\n\n      --summarize-only\n          Only summarize latest results\n\n  -h, --help\n          Print help (see a summary with '-h')\n\n  -V, --version\n          Print version\n```\n\n## Cronjob setup\n\nSet up a cronjob (ideally 2+ hours after UTC midnight) and run the following command to generate daily data:\n\n```bash\nribeye cook --dir /DATA/PATH/TO/OUTPUT/DIRECTORY\n```\n\nSee the Hashicorp Nomad [job spec](deployment/nomad_periodic_raw.hcl) for an example Nomad deployment.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbgpkit%2Fribeye","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbgpkit%2Fribeye","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbgpkit%2Fribeye/lists"}