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

Adds metrics framework documentation #6393

Merged
merged 9 commits into from
Feb 15, 2024

Conversation

Gaganjuneja
Copy link
Contributor

@Gaganjuneja Gaganjuneja commented Feb 12, 2024

Description

Describe what this change achieves.

Issues Resolved

List any issues this PR will resolve, e.g. Closes [...].

Closes #6338

Checklist

  • [ x] 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: Gagan Juneja <gjjuneja@amazon.com>
Gagan Juneja added 3 commits February 12, 2024 02:22
Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>
Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>
Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>
@hdhalter hdhalter added release-notes PR: Include this PR in the automated release notes v2.12.0 labels Feb 12, 2024
@Naarcha-AWS Naarcha-AWS added the 4 - Doc Review PR: Doc review in progress label Feb 12, 2024
@Gaganjuneja
Copy link
Contributor Author

@reta please take a look.

_monitoring-your-cluster/index.md Show resolved Hide resolved
_monitoring-your-cluster/index.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
Gaganjuneja and others added 3 commits February 14, 2024 14:11
Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Andriy Redko <drreta@gmail.com>
Signed-off-by: Gagan Juneja <gagandeepjuneja@gmail.com>
Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
@Naarcha-AWS Naarcha-AWS added 5 - Final Editorial Review PR: Editorial Review in progress and removed 4 - Doc Review PR: Doc review in progress labels Feb 14, 2024
@Gaganjuneja
Copy link
Contributor Author

@Naarcha-AWS and @reta thanks for your help here.

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.

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

- OpenSearch [Job Scheduler]({{site.url}}{{site.baseurl}}/monitoring-your-cluster/job-scheduler/index/) plugin provides a framework that you can use to build schedules for common cluster management tasks.
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
- OpenSearch [Job Scheduler]({{site.url}}{{site.baseurl}}/monitoring-your-cluster/job-scheduler/index/) plugin provides a framework that you can use to build schedules for common cluster management tasks.
- The OpenSearch [Job Scheduler]({{site.url}}{{site.baseurl}}/monitoring-your-cluster/job-scheduler/index/) plugin provides a framework that you can use to build schedules for common cluster management tasks.

_monitoring-your-cluster/index.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
_monitoring-your-cluster/metrics/getting-started.md Outdated Show resolved Hide resolved
The metrics framework supports various telemetry solutions through plugins. Use the following instructions to enable the `telemetry-otel` plugin:


1. **Publish Interval:** The Metrics Framework can locally aggregate the metrics with unique dimensions about the configured publish interval, and then export those metrics. By default, the interval is 1 minute. However, you be change the interval using the `telemetry.otel.metrics.publish.interval` cluster setting.
Copy link
Collaborator

Choose a reason for hiding this comment

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

"dimensions" reads as the wrong word here. Do we mean "information"?

telemetry.feature.metrics.enabled=true
```

The metrics framework supports various telemetry solutions through plugins. Use the following instructions to enable the `telemetry-otel` plugin:
Copy link
Collaborator

Choose a reason for hiding this comment

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

The two items below do not read as "instructions" (we don't tell the reader to do anything).

Naarcha-AWS and others added 2 commits February 15, 2024 10:25
Co-authored-by: Nathan Bower <nbower@amazon.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
@Naarcha-AWS Naarcha-AWS added 6 - Done but waiting to merge PR: The work is done and ready to merge and removed 5 - Final Editorial Review PR: Editorial Review in progress labels Feb 15, 2024
@Naarcha-AWS Naarcha-AWS merged commit ad2e88a into opensearch-project:main Feb 15, 2024
4 checks passed
@hdhalter hdhalter added 3 - Done Issue is done/complete and removed 6 - Done but waiting to merge PR: The work is done and ready to merge labels Feb 15, 2024
oeyh pushed a commit to oeyh/documentation-website that referenced this pull request Mar 14, 2024
* Adds metrics framework documentation

Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>

* Fixes vale issues

Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>

* fix issues

Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>

* Fix dead link issue

Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>

* Apply suggestions from code review

Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Andriy Redko <drreta@gmail.com>
Signed-off-by: Gagan Juneja <gagandeepjuneja@gmail.com>

* Address review commit

Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>

* Add formatting fixes and editorial feedback

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>

---------

Signed-off-by: Gagan Juneja <gjjuneja@amazon.com>
Signed-off-by: Gagan Juneja <gagandeepjuneja@gmail.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Gagan Juneja <gjjuneja@amazon.com>
Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Andriy Redko <drreta@gmail.com>
Co-authored-by: Nathan Bower <nbower@amazon.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
3 - Done Issue is done/complete release-notes PR: Include this PR in the automated release notes v2.12.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOC] Metrics Framework
5 participants