{"id":13582123,"url":"https://github.com/giacomoguiulfo/benchio","last_synced_at":"2025-04-06T13:32:51.558Z","repository":{"id":34654309,"uuid":"149100741","full_name":"giacomoguiulfo/benchio","owner":"giacomoguiulfo","description":"⏳A minimalistic tool to benchmark AWS S3 compatible object storage services https://giacomoguiulfo.github.io/benchio/","archived":false,"fork":false,"pushed_at":"2022-06-16T03:12:46.000Z","size":563,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-05T22:39:43.073Z","etag":null,"topics":["aws","azure","benchmark","cli","cloudserver","gcp","golang","minio","s3","zenko"],"latest_commit_sha":null,"homepage":"","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/giacomoguiulfo.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":"2018-09-17T09:25:12.000Z","updated_at":"2023-05-25T04:07:36.000Z","dependencies_parsed_at":"2022-09-15T23:20:23.858Z","dependency_job_id":null,"html_url":"https://github.com/giacomoguiulfo/benchio","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giacomoguiulfo%2Fbenchio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giacomoguiulfo%2Fbenchio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giacomoguiulfo%2Fbenchio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giacomoguiulfo%2Fbenchio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/giacomoguiulfo","download_url":"https://codeload.github.com/giacomoguiulfo/benchio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247488850,"owners_count":20947014,"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":["aws","azure","benchmark","cli","cloudserver","gcp","golang","minio","s3","zenko"],"created_at":"2024-08-01T15:02:26.418Z","updated_at":"2025-04-06T13:32:51.213Z","avatar_url":"https://github.com/giacomoguiulfo.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# benchio\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/giacomoguiulfo/benchio)](https://goreportcard.com/report/github.com/giacomoguiulfo/benchio)\n[![Go Doc](https://img.shields.io/badge/godoc-reference-blue.svg?style=flat-square)](http://godoc.org/github.com/giacomoguiulfo/benchio)\n[![Release](https://img.shields.io/github/release/giacomoguiulfo/benchio.svg?style=flat-square)](https://github.com/giacomoguiulfo/benchio/releases/latest)\n\nA lightweight minimalistic tool to benchmark AWS S3 compatible object storage services.\nBenchio is a fork of [s3bench](https://github.com/igneous-systems/s3bench) to further extend its functionality.\n\n# Getting Started\n\n## Requirements\n\n - golang \u003e=1.9\n\n## Installation\n\n```sh\ngo get -u https://github.com/giacomoguiulfo/benchio.git\n```\n\n## Simple usage\n\n```\nbenchio run -f benchio.yaml\n```\n\u003e This assumes that the `GOBIN` environmental variable (`GOPATH/bin`) is in your `PATH`.\n\n## Advanced Usage\n\nOptions can be used as command line arguments or stored in a configuration file\nwhich supports YAML, JSON, or TOML formats.\n\nThe default benchio.yaml file contains all the necessary values to run a basic\nread/write/cleanup workload.\n\n```yaml\naccessKey: MZZRYNUQKEJZUTKLLHAD\nsecretKey: hRwZ5GA7VUhh=vLdBLUqZuRqcryqyVHhuCopR5a4\nendpoint: http://localhost:8000\nbucket: testbucket\nobjectSize: 1024\nobjectNamePrefix: testobject\nnumClients: 10\nnumSamples: 100\nverbose: false\nregion: us-east-1\ncleanup: true\nwrite: true\nread: true\n```\n\n## Available Parameters\n\n| Parameter                           | Description                                                                                                      |\n| ----------------------------------- | -----------------------------------------------------------------------------------------------------------------|\n| `accessKey`                         | This is your user access key to access given buckets                                                             |\n| `secretKey`                         | This is the secret key used to access given buckets                                                              |\n| `endpoint`                          | These are endpoint targets for the workloads. Multiple can be passed as a comma separated list.                  |\n| `bucket`                            | The target bucket to be used. Must already be created on the specified endpoint                                  |\n| `objectSize`                        | Size for each object to be used in the workload (Currently measured in bytes)                                    |\n| `objectNamePrefix`                  | Prefix to be used in the object naming                                                                           |\n| `numClients`                        | Number of clients, also referred to as 'workers'                                                                 |\n| `numSamples`                        | Number of objects to server to the endpoint                                                                      |\n| `verbose`                           | Gives more information on each object operation                                                                  |\n| `region`                            | The AWS compatible region where your bucket is located                                                           |\n| `write`                             | A bool to enable/disable writes, typically this will be the first operation to run                               |\n| `read`                              | A bool to enable/disable reads, runs after writes have completed (currently buggy if using only read operations) |\n| `cleanup`                           | A bool to enable/disable cleanup operations after successful read/writes                                         |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiacomoguiulfo%2Fbenchio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiacomoguiulfo%2Fbenchio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiacomoguiulfo%2Fbenchio/lists"}