benchio
A lightweight minimalistic tool to benchmark AWS S3 compatible object storage services. Benchio is a fork of s3bench to further extend its functionality.
Getting Started
Requirements
- golang >=1.9
Installation
go get -u https://github.com/giacomoguiulfo/benchio.gitSimple usage
benchio run -f benchio.yaml
This assumes that the
GOBINenvironmental variable (GOPATH/bin) is in yourPATH.
Advanced Usage
Options can be used as command line arguments or stored in a configuration file which supports YAML, JSON, or TOML formats.
The default benchio.yaml file contains all the necessary values to run a basic read/write/cleanup workload.
accessKey: MZZRYNUQKEJZUTKLLHAD
secretKey: hRwZ5GA7VUhh=vLdBLUqZuRqcryqyVHhuCopR5a4
endpoint: http://localhost:8000
bucket: testbucket
objectSize: 1024
objectNamePrefix: testobject
numClients: 10
numSamples: 100
verbose: false
region: us-east-1
cleanup: true
write: true
read: trueAvailable Parameters
| Parameter | Description |
|---|---|
accessKey |
This is your user access key to access given buckets |
secretKey |
This is the secret key used to access given buckets |
endpoint |
These are endpoint targets for the workloads. Multiple can be passed as a comma separated list. |
bucket |
The target bucket to be used. Must already be created on the specified endpoint |
objectSize |
Size for each object to be used in the workload (Currently measured in bytes) |
objectNamePrefix |
Prefix to be used in the object naming |
numClients |
Number of clients, also referred to as 'workers' |
numSamples |
Number of objects to server to the endpoint |
verbose |
Gives more information on each object operation |
region |
The AWS compatible region where your bucket is located |
write |
A bool to enable/disable writes, typically this will be the first operation to run |
read |
A bool to enable/disable reads, runs after writes have completed (currently buggy if using only read operations) |
cleanup |
A bool to enable/disable cleanup operations after successful read/writes |
