{"id":20102938,"url":"https://github.com/stackrox/berserker","last_synced_at":"2025-10-06T03:52:03.619Z","repository":{"id":238460052,"uuid":"645920389","full_name":"stackrox/berserker","owner":"stackrox","description":"Workload generator for ACS Collector","archived":false,"fork":false,"pushed_at":"2025-09-16T12:57:22.000Z","size":222,"stargazers_count":14,"open_issues_count":8,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-16T14:56:00.249Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stackrox.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-05-26T18:59:45.000Z","updated_at":"2025-09-16T12:57:26.000Z","dependencies_parsed_at":"2024-08-12T12:01:08.340Z","dependency_job_id":"dd29f5f3-5df1-4de7-bf55-c975044fe9da","html_url":"https://github.com/stackrox/berserker","commit_stats":null,"previous_names":["stackrox/berserker"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/stackrox/berserker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Fberserker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Fberserker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Fberserker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Fberserker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stackrox","download_url":"https://codeload.github.com/stackrox/berserker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Fberserker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278556190,"owners_count":26006080,"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-10-06T02:00:05.630Z","response_time":65,"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-13T17:33:44.244Z","updated_at":"2025-10-06T03:52:03.584Z","avatar_url":"https://github.com/stackrox.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Berserker\n\nWorkload generator for benchmarking ACS Collector, that supports following\nworkloads:\n\n* Processes based workload to simulate systems with large number of processes.\n  Processes spawning and exiting is modelled by a Poisson process \\[1\\] with\n  specified rates of arrival and departure. In this way the tool can model an\n  open system with more realistic latencies \\[2\\].\n\n  The workload can function in two ways: either only forking the current\n  process, or do fork plus exec with a randomly generated parameters into a\n  small binary, which will immediately exit. The first approach will hit the\n  path where process events are getting filtered out on the Collector level,\n  the second will make Collector fully process events and send them further.\n\n* Endpoint based workload to simulate systems with large number of network\n  listening activity. Every worker opens and listens on a number of ports,\n  modelled by Zipf \\[3\\] or uniform distributions (to cover extreme cases, when\n  one process has significantly more endpoints than others).\n\n* Syscall based workload to evaluate certain type of edge cases. Intended to\n  verify an overhead where normally Collector doesn't stay in the way, but\n  could be with the vanilla Falco. Similarly to the process based workload,\n  syscalls are also modelled by a Poisson process.\n\n* Network based workload to simulate systems with large number of open\n  connections coming from variety of different addresses. To reduce amount of\n  resources needed for such simulation and be able to pretend a connection is\n  coming from a particular address, a tun device is used to craft an external\n  client connection in the userspace.\n\n* BPF based workload, which creates a specified number of simple BPF programs,\n  attached to a specified tracepoint. This allows to simulate program\n  contention on the same attachment point.\n\n# Configuration\n\nThere are few ways to tune the configuration:\n\n* If nothing is provided, Berserker will search for a file at\n  `/etc/berserker/workload.toml`\n\n* The target configuration can be provided via the first commandline argument,\n  i.e. `berserker workload.toml`\n\n* The configuration could be further adjusted via environment variables, e.g.\n  `BERSERKER__WORKLOAD__ARRIVAL_RATE=1`. Such a variable have to start with the\n  prefix `BERSERKER__` and use `__` to change nesting level.\n\nYou can specify which workload you want to use via option `type`. For every\ntype of workload there is an example in the `workloads/` directory.\n\nA workload can be executed using one or more worker processes. By default one\nworker is spawn per CPU core and and pinned to it to fully utilize system\nresources. For some workload it might be needed to have a specified number of\nworker instead without any implied affinity -- in this case they could be\nconfigured usign option `per_core` and `workers`.\n\n# How to contribute\n\n* Make sure you've got recent enough version of Rust compiler. At the moment\n  the minimal required version is 1.80 .\n\n* Build project either directly using `cargo build`, or using containerized\n  version implemented as a make `all` target.\n\n* Find out what you need to change. The rule of thumb: if it has something to\n  do with a specific workload type, it goes into a corresponding workload\n  module under the `worker` directory; if it's a general improvement, feel free\n  to modify anything outside workers.\n\n* Do all sorts of hacking. Use `RUST_LOG=info` environment variable for getting\n  verbose output when troubleshooting.\n\n* Make sure tests are passing, `cargo test`.\n\n* Run linter and formatter, `cargo clippy` \u0026 `cargo fmt`.\n\n\\[1\\]: https://en.wikipedia.org/wiki/Poisson_point_process\n\n\\[2\\]: \"Open versus closed: A cautionary tale\". Schroeder, B., Wierman, A. and\nHarchol-Balter, M., USENIX. 2006.\n\n\\[3\\]: https://en.wikipedia.org/wiki/Zipf%27s_law\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackrox%2Fberserker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstackrox%2Fberserker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackrox%2Fberserker/lists"}