Skip to main content
https://badge.fury.io/py/os-benchmark.svg https://travis-ci.org/cloudmercato/os-benchmark.svg?branch=master https://coveralls.io/repos/github/cloudmercato/os-benchmark/badge.svg?branch=master Documentation Status

OS-Benchmark is a simple tool to measure object storage operations.

Features

Benchmarks

  • Upload Timing

  • Download Timing

  • Apache Benchmark

Install

pip install os-benchmark

Usage

Configuration

You need to specify a YAML config file such as following:

---
my_exoscale:                                  # Configuration ID
    driver: exoscale                          # Driver key
    aws_access_key_id: mykey                  # Drivers params
    aws_secret_access_key: mysecrect
    endpoint_url: https://sos-ch-dk-2.exo.io

In command line, --config-file and --config-raw can be used to make the choice, else ~/.osb.yml, then /etc/osb.yml will be used.

Command line

os-benchmark --help
usage: os-benchmark [--config-file CONFIG_FILE] [--config-raw CONFIG_RAW]
                  [--config-name CONFIG_NAME] [-v {0,1,2}] [-i]
                  {help,create-bucket,list-buckets,delete-bucket,list-objects,upload,delete-object,clean-bucket,clean,time-upload,time-download}
                  ...

positional arguments:
  {help,create-bucket,list-buckets,delete-bucket,list-objects,upload,delete-object,clean-bucket,clean,time-upload,time-download}
                      Sub-command

optional arguments:
  --config-file CONFIG_FILE
                      Specify a configuration file to use.
  --config-raw CONFIG_RAW
                      Provide a raw configuration as JSON instead of a
                      stored file.
  --config-name CONFIG_NAME
                      Select a driver configuration to use.
  -v {0,1,2}, --verbosity {0,1,2}
                      Verbosity level; 0=minimal output, 1=normal output
                      2=verbose output
  -i, --noinput       Disable any prompt

Test example: File uploading

$ os-benchmark time-upload --object-size 1 --object-number 5
version         0.1
operation       upload
ops             5
time            2.701468
rate            1.850845
bw              0.000002
object_size     1
total_size      5
avg             0.539478
stddev          0.126987
med             0.537267
min             0.415063
max             0.744637

Contribute

This project is created with ❤️ for free by Cloud Mercato under BSD License. Feel free to contribute by submitting a pull request or an issue.

Metadata

Release files for os-benchmark 0.7.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for os-benchmark 0.7.4
File Size Uploaded Provenance Actions
os-benchmark-0.7.4.tar.gz 25.3 kB Without provenance Details for os-benchmark-0.7.4.tar.gz

Release files / os-benchmark-0.7.4.tar.gz

Download URL os-benchmark-0.7.4.tar.gz
Size 25.3 kB
Tags Source
SHA-256 checksum
How to use checksums
01ee36cc816c0e75443f1433ed77a05271b76af5186c69147a4f0f4a6d560f0d
BLAKE2b-256 checksum
How to use checksums
af78a5331827dad048e09a6f85a7626fb451a47d083cb323d40746d80643d4b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.7.1

Security for os-benchmark 0.7.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page