Metadata-Version: 2.4
Name: opensearch-benchmark
Version: 2.3.0
Summary: Macrobenchmarking framework for OpenSearch
Home-page: https://github.com/opensearch-project/OpenSearch-Benchmark
Author: Ian Hoang, Govind Kamat, Mingyang Shi, Chinmay Gadgil, Rishabh Singh, Vijayan Balasubramanian
Author-email: ianhoang16@gmail.com, govind_kamat@yahoo.com, mmyyshi@gmail.com, chinmay5j@gmail.com, rishabhksingh@gmail.com, vijayan.balasubramanian@gmail.com
Maintainer: Ian Hoang, Govind Kamat, Mingyang Shi, Chinmay Gadgil, Rishabh Singh, Vijayan Balasubramanian
Maintainer-email: ianhoang16@gmail.com, govind_kamat@yahoo.com, mmyyshi@gmail.com, chinmay5j@gmail.com, rishabhksingh@gmail.com, vijayan.balasubramanian@gmail.com
License: Apache License, Version 2.0
Project-URL: Documentation, https://opensearch.org/docs/benchmark
Project-URL: Source Code, https://github.com/opensearch-project/OpenSearch-Benchmark
Project-URL: Issue Tracker, https://github.com/opensearch-project/OpenSearch-Benchmark/issues
Classifier: Topic :: System :: Benchmark
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10,<3.14
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
License-File: AUTHORS
Requires-Dist: opensearch-py[async]<3.0.0,>=2.5.0
Requires-Dist: psutil>=5.8.0
Requires-Dist: py-cpuinfo>=7.0.0
Requires-Dist: tabulate>=0.9.0
Requires-Dist: jsonschema>=3.1.1
Requires-Dist: Jinja2>=3.1.3
Requires-Dist: markupsafe>=2.0.1
Requires-Dist: thespian<3.10.7,>=3.10.1
Requires-Dist: certifi
Requires-Dist: yappi>=1.4.0
Requires-Dist: ijson>=2.6.1
Requires-Dist: google-resumable-media>=1.1.0
Requires-Dist: google-auth>=1.22.1
Requires-Dist: wheel>=0.38.4
Requires-Dist: boto3>=1.28.62
Requires-Dist: zstandard>=0.22.0
Requires-Dist: h5py>=3.10.0
Requires-Dist: numpy<=1.26.4,>=1.24.2
Requires-Dist: aiokafka>=0.11.0
Requires-Dist: tqdm
Requires-Dist: faker
Requires-Dist: mimesis==11.1.0
Requires-Dist: pandas>=1.5.0
Requires-Dist: dask
Requires-Dist: dask[distributed]
Requires-Dist: bokeh!=3.0.*,>=2.4.2
Requires-Dist: pydantic>=2.10.6
Requires-Dist: pydantic_core>=2.27.2
Requires-Dist: opensearch-protobufs==1.2.0
Provides-Extra: develop
Requires-Dist: ujson; extra == "develop"
Requires-Dist: pytest==7.2.2; extra == "develop"
Requires-Dist: pytest-benchmark==3.2.2; extra == "develop"
Requires-Dist: pytest-asyncio==0.14.0; extra == "develop"
Requires-Dist: tox==3.14.0; extra == "develop"
Requires-Dist: coverage==5.5; extra == "develop"
Requires-Dist: twine==6.0.1; extra == "develop"
Requires-Dist: wheel>=0.38.4; extra == "develop"
Requires-Dist: github3.py==1.3.0; extra == "develop"
Requires-Dist: pylint==2.9.0; extra == "develop"
Requires-Dist: pylint-quotes==0.2.1; extra == "develop"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

[![CI](https://github.com/opensearch-project/opensearch-benchmark/actions/workflows/main.yml/badge.svg)](https://github.com/opensearch-project/opensearch-benchmark/actions/workflows/main.yml)
[![Integration](https://github.com/opensearch-project/opensearch-benchmark/actions/workflows/manual-integ.yml/badge.svg)](https://github.com/opensearch-project/opensearch-benchmark/actions/workflows/manual-integ.yml)
[![Release](https://github.com/opensearch-project/opensearch-benchmark/actions/workflows/publish-release.yml/badge.svg)](https://github.com/opensearch-project/opensearch-benchmark/actions/workflows/publish-release.yml)
[![Version](https://img.shields.io/pypi/v/opensearch-benchmark.svg?color=blue)](https://pypi.org/project/opensearch-benchmark/)
![PyPI Downloads](https://static.pepy.tech/badge/opensearch-benchmark)
[![Chat](https://img.shields.io/badge/chat-on%20forums-blue)](https://forum.opensearch.org/categories)
![PRs welcome!](https://img.shields.io/badge/PRs-welcome!-success)

<img src="https://github.com/opensearch-project/opensearch-benchmark/blob/main/opensearch_benchmark.png?raw=true"  height="64px" alt="OpenSearch Benchmark">

OpenSearch Benchmark is the macrobenchmarking framework for OpenSearch.

What is OpenSearch Benchmark?
-----------------------------

If you are looking to performance test OpenSearch, then OpenSearch Benchmark is for you. It can help you with the following tasks:

* Running performance benchmarks and recording results
* Setting up and tearing down OpenSearch clusters for benchmarking
* Managing benchmark data and specifications across OpenSearch versions
* Discovering performance problems by attaching so-called telemetry devices
* Comparing performance results
* Creating customized workloads

We have also put considerable effort into OpenSearch Benchmark to ensure that benchmarking data are reproducible.

Documentation
-------------

Official documentation for OpenSearch Benchmark is [available online](https://opensearch.org/docs/latest/benchmark/index/).

Quick Start
-----------

Want to get started with OpenSearch Benchmark quickly? See [OpenSearch Benchmark's Quick Start guide in the documentation](https://opensearch.org/docs/latest/benchmark/index/).

Getting help
------------

* Quick help: ``opensearch-benchmark --help``
* Want to contribute? Look at [OpenSearch Benchmark's Developer Guide](<https://github.com/opensearch-project/OpenSearch-Benchmark/blob/main/DEVELOPER_GUIDE.md>) for more information
* For any questions or answers, visit our [community forum](<https://discuss.opendistrocommunity.dev/>) and Slack community channel [#performance-benchmarking](https://opensearch.slack.com/archives/C082PLA3VPW).
* File improvements or bug reports in our [Github repo](<https://github.com/opensearch-project/OpenSearch-Benchmark/issues>).

How to Contribute
-----------------

See all details in the [contributor guidelines](<https://github.com/opensearch-project/OpenSearch-Benchmark/blob/main/CONTRIBUTING.md>).

License
-------

This software is licensed under the Apache License, version 2 ("ALv2"), quoted below.

Copyright 2015-2022 OpenSearch <https://opensearch.org/>

Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.
