This is not an officially supported Google product
This runs 1000 iterations on 512kib to 2Gib files in the background, sending output to out.log:
go run main -project {PROJECT_ID} -samples 1000 -object_size=524288..2147483648 -o {RESULTS_FILE_NAME} &> out.log &
| Parameter | Description | Possible values | Default |
|---|---|---|---|
| -project | projectID | a project ID | * |
| -bucket | bucket supplied for benchmarks must be initialized | any GCS region | will create a randomly named bucket |
| -bucket_region | bucket region for benchmarks ignored if bucket is explicitly supplied | any GCS region | US-WEST1 |
| -o | file to output results to if empty, will output to stdout | any file path | stdout |
| -output_type | output results as csv records or cloud monitoring | csv, cloud-monitoring | cloud-monitoring |
| -samples | number of samples to report | any positive integer | 8000 |
| -workers | number of goroutines to run at once; set to 1 for no concurrency | any positive integer | 16 |
| -clients | total number of Storage clients to be used; if Mixed APIs, then x3 the number are created | any positive integer | 1 |
| -api | which API to use | JSON: use JSON XML: use JSON to upload and XML to download GRPC: use GRPC without directpath enabled Mixed: select an API at random for each object DirectPath: use GRPC with directpath | Mixed |
| -object_size | object size in bytes; can be a range min..max | any positive integer | 1 048 576 (1 MiB) |
| -range_read_size | size of the range to read in bytes | any positive integer <=0 reads the full object | 0 |
| -minimum_read_offset | minimum offset for the start of the range to be read in bytes | any integer >0 | 0 |
| -maximum_read_offset | maximum offset for the start of the range to be read in bytes | any integer >0 | 0 |
| -read_buffer_size | read buffer size in bytes | any positive integer | 4096 for HTTP 32768 for GRPC |
| -write_buffer_size | write buffer size in bytes | any positive integer | 4096 for HTTP 32768 for GRPC |
| -min_chunksize | minimum ChunkSize in bytes | any positive integer | 16 384 (16 MiB) |
| -max_chunksize | maximum ChunkSize in bytes | any positive integer | 16 384 (16 MiB) |
| -connection_pool_size | GRPC connection pool size | any positive integer | 4 |
| -force_garbage_collection | whether to force garbage collection before every write or read benchmark | true or false (present/not present) | false |
| -timeout | timeout (maximum time running benchmarks) the program may run for longer while it finishes running processes | any time.Duration | 1h |
* required values