Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add documentation for new aggregate command + auto aggregation #8521

Merged

Conversation

OVI3D0
Copy link
Member

@OVI3D0 OVI3D0 commented Oct 11, 2024

Description

Adds documentation for the new aggregate command, introduced in OSB here, as well as automatic aggregation of test results, introduced here.

Version

OpenSearch Benchmark

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

Signed-off-by: Michael Oviedo <mikeovi@amazon.com>
Copy link

Thank you for submitting your PR. The PR states are In progress (or Draft) -> Tech review -> Doc review -> Editorial review -> Merged.

Before you submit your PR for doc review, make sure the content is technically accurate. If you need help finding a tech reviewer, tag a maintainer.

When you're ready for doc review, tag the assignee of this PR. The doc reviewer may push edits to the PR directly or leave comments and editorial suggestions for you to address (let us know in a comment if you have a preference). The doc reviewer will arrange for an editorial review.

Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
@Naarcha-AWS Naarcha-AWS added 5 - Editorial review PR: Editorial review in progress backport 2.17 Backport for version 2.17 labels Oct 16, 2024
Copy link
Collaborator

@natebower natebower left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@OVI3D0 @Naarcha-AWS Please see my comments and changes and let me know if you have any questions. Thanks!

_benchmark/reference/commands/aggregate.md Outdated Show resolved Hide resolved
_benchmark/reference/commands/aggregate.md Outdated Show resolved Hide resolved
## Auto-aggregation

Auto-aggregation runs multiple iterations of benchmark tests and automatically aggregate the results, all within a single command. You can use the flags outlined in this with the `execute` command.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Above: It looks like there's a missing word in the second sentence. This what?

_benchmark/reference/commands/aggregate.md Outdated Show resolved Hide resolved
_benchmark/reference/commands/aggregate.md Outdated Show resolved Hide resolved

### Usage

To aggregate multiple test executions manually, you can use the aggregate command:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To aggregate multiple test executions manually, you can use the aggregate command:
To aggregate multiple test executions manually, you can use the `aggregate` command:

### Usage

To aggregate multiple test executions manually, you can use the aggregate command:

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Above: This sentence is a rehash of the one under the preceding heading.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let me change this one.

_benchmark/reference/commands/aggregate.md Outdated Show resolved Hide resolved
_benchmark/reference/commands/aggregate.md Outdated Show resolved Hide resolved
_benchmark/reference/commands/aggregate.md Outdated Show resolved Hide resolved
Naarcha-AWS and others added 3 commits October 17, 2024 05:45
Co-authored-by: Nathan Bower <nbower@amazon.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
@Naarcha-AWS Naarcha-AWS added the 6 - Done but waiting to merge PR: The work is done and ready to merge label Oct 17, 2024
@Naarcha-AWS Naarcha-AWS merged commit c6c0041 into opensearch-project:main Oct 17, 2024
6 checks passed
opensearch-trigger-bot bot pushed a commit that referenced this pull request Oct 17, 2024
* add documentation for new aggregate command + auto aggregation

Signed-off-by: Michael Oviedo <mikeovi@amazon.com>

* Update aggregate.md

Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>

* Update command-flags.md

Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Nathan Bower <nbower@amazon.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>

* Update aggregate.md

Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>

---------

Signed-off-by: Michael Oviedo <mikeovi@amazon.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Nathan Bower <nbower@amazon.com>
(cherry picked from commit c6c0041)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
5 - Editorial review PR: Editorial review in progress 6 - Done but waiting to merge PR: The work is done and ready to merge backport 2.17 Backport for version 2.17
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants