Metadata-Version: 2.4
Name: apache-otava
Version: 0.8.0
Summary: Apache Otava (Incubating): Change Detection for Continuous Performance Engineering
Project-URL: Homepage, https://otava.apache.org
Project-URL: Documentation, https://otava.apache.org/docs/overview
Project-URL: Repository, https://github.com/apache/otava
Project-URL: Bug Tracker, https://github.com/apache/otava/issues
Author-email: "Apache Otava (Incubating)" <dev@otava.apache.org>
Maintainer-email: "Apache Otava (Incubating)" <dev@otava.apache.org>
License: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: <3.15,>=3.10
Requires-Dist: configargparse>=1.7.1
Requires-Dist: dateparser>=1.0.0
Requires-Dist: google-cloud-bigquery>=3.38.0
Requires-Dist: numpy==2.2.0.*
Requires-Dist: pg8000>=1.31.5
Requires-Dist: pystache>=0.6.8
Requires-Dist: python-dateutil>=2.9.0
Requires-Dist: requests>=2.32.5
Requires-Dist: ruamel-yaml==0.18.16
Requires-Dist: scipy<1.16,>=1.15; python_version < '3.11'
Requires-Dist: scipy<1.17,>=1.16; python_version >= '3.11'
Requires-Dist: slack-sdk>=3.39.0
Requires-Dist: tabulate>=0.9.0
Requires-Dist: validators>=0.35.0
Provides-Extra: dev
Requires-Dist: autoflake>=2.3.1; extra == 'dev'
Requires-Dist: flake8>=7.3.0; extra == 'dev'
Requires-Dist: isort>=7.0.0; extra == 'dev'
Requires-Dist: pre-commit==4.5.0; extra == 'dev'
Requires-Dist: pytest-benchmark>=5.2.3; extra == 'dev'
Requires-Dist: pytest>=9.0.1; extra == 'dev'
Requires-Dist: pytz==2025.2; extra == 'dev'
Requires-Dist: ruff>=0.14.8; extra == 'dev'
Requires-Dist: tox==4.32.0; extra == 'dev'
Description-Content-Type: text/markdown

Apache Otava – Change Detection for Continuous Performance Engineering
===============================================================

[![License](https://img.shields.io/:license-Apache%202-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0.txt)
[![PyPI version](https://img.shields.io/pypi/v/apache-otava.svg)](https://pypi.org/project/apache-otava/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/apache-otava.svg)](https://pypi.org/project/apache-otava/)


Apache Otava (incubating) performs statistical analysis of performance test results stored
in CSV files, PostgreSQL, BigQuery, or Graphite database. It finds change-points and notifies about
possible performance regressions.

A typical use-case of otava is as follows:

- A set of performance tests is scheduled repeatedly, such as after each commit is pushed.
- The resulting metrics of the test runs are stored in a time series database (Graphite)
   or appended to CSV files.
- Otava is launched by a Jenkins/Cron job (or an operator) to analyze the recorded
  metrics regularly.
- Otava notifies about significant changes in recorded metrics by outputting text reports or
  sending Slack notifications.

Otava is capable of finding even small, but persistent shifts in metric values,
despite noise in data. It adapts automatically to the level of noise in data and
tries to notify only about persistent, statistically significant changes, be it in the system
under test or in the environment.

Unlike in threshold-based performance monitoring systems, there is no need to setup fixed warning
threshold levels manually for each recorded metric. The level of accepted probability of
false-positives, as well as the minimal accepted magnitude of changes are tunable. Otava is
also capable of comparing the level of performance recorded in two different git histories.
This can be used for example to validate a feature branch against the main branch, perhaps
integrated with a pull request.

See the documentation in https://otava.apache.org/docs/overview/.

## Supported Python Versions

Apache Otava is tested against Python 3.10, 3.11, 3.12, 3.13, and 3.14.


## License

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.

## Disclaimer

Apache Otava (incubating) is an effort undergoing incubation at the Apache
Software Foundation (ASF), sponsored by the Apache Incubator PMC.

Incubation is required of all newly accepted projects until a further review
indicates that the infrastructure, communications, and decision making process
have stabilized in a manner consistent with other successful ASF projects.

While incubation status is not necessarily a reflection of the completeness
or stability of the code, it does indicate that the project has yet to be
fully endorsed by the ASF.
