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

[receiver/hostmetrics] Add documentation for mute_*_error configuration fields #32494

Merged
merged 8 commits into from
Jul 22, 2024

Conversation

bsponge
Copy link
Contributor

@bsponge bsponge commented Apr 17, 2024

Description:
Added documentation for mute_*_error configuration fields and updated comments in the code.

Link to tracking Issue:
Resolves #30779

Testing: not applicable

Documentation: Added missing documentation of mute_*_error configuration in hostmetricsreceiver

@bsponge bsponge requested a review from dmitryax as a code owner April 17, 2024 18:46
@bsponge bsponge requested a review from a team April 17, 2024 18:46
Copy link

linux-foundation-easycla bot commented Apr 17, 2024

CLA Signed

The committers listed above are authorized under a signed CLA.

Copy link
Contributor

@braydonk braydonk left a comment

Choose a reason for hiding this comment

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

Hi @bsponge, thanks for opening a PR for this!

Unfortunately, the documentation can't be added where you have it here; note at the top of that file that it mentions it is autogenerated and thus shouldn't be edited.

What I'd suggest instead is adding it to the README.md in the root hostmetricsreceiver folder. In there, you'll see a section that shows the configuration options for every scraper. This can definitely be improved, but for now if you could add those descriptions directly below the yaml example that would be good for now.

The rest of the PR looks good to me.

Copy link
Contributor

@braydonk braydonk left a comment

Choose a reason for hiding this comment

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

Thanks, looks good to me! Will still need approval from dmitryax before merge.

Copy link
Member

@crobert-1 crobert-1 left a comment

Choose a reason for hiding this comment

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

Thanks for your PR, always appreciate documentation enhancements!

.chloggen/add-mute-error-documentation.yaml Outdated Show resolved Hide resolved
receiver/hostmetricsreceiver/README.md Outdated Show resolved Hide resolved
@crobert-1 crobert-1 added documentation Improvements or additions to documentation Skip Changelog PRs that do not require a CHANGELOG.md entry labels Apr 17, 2024
@crobert-1
Copy link
Member

Hope you don't mind, I updated your PR description to automatically close the linked issue 👍

Copy link
Contributor

github-actions bot commented May 2, 2024

This PR was marked stale due to lack of activity. It will be closed in 14 days.

@github-actions github-actions bot added the Stale label May 2, 2024
@braydonk
Copy link
Contributor

braydonk commented May 2, 2024

unstale

@crobert-1 crobert-1 removed the Stale label May 2, 2024
Copy link
Contributor

This PR was marked stale due to lack of activity. It will be closed in 14 days.

@github-actions github-actions bot added the Stale label May 17, 2024
Copy link
Contributor

Closed as inactive. Feel free to reopen if this PR is still being worked on.

@github-actions github-actions bot closed this May 31, 2024
@rogercoll
Copy link
Contributor

Could we reopen this PR? This is still important documentation we should have in the process scrapper.

@crobert-1 crobert-1 reopened this Jul 17, 2024
@crobert-1 crobert-1 added the ready to merge Code review completed; ready to merge by maintainers label Jul 17, 2024
@crobert-1
Copy link
Member

Added ready to merge as it's been approved by an approver and code owner.

@crobert-1 crobert-1 removed the Stale label Jul 17, 2024
@braydonk
Copy link
Contributor

@crobert-1 Maybe you'll know the answer to this. I'm not sure if as a codeowner in .github/CODEOWNERS my approval is supposed to count for codeowner approval according to GitHub (still has the grey checkmark here and in other PRs). This has been the case for a while but I wasn't sure if it was intentional or not, if I mixed something up with adding myself as a codeowner I can try to fix it.

@crobert-1
Copy link
Member

@crobert-1 Maybe you'll know the answer to this. I'm not sure if as a codeowner in .github/CODEOWNERS my approval is supposed to count for codeowner approval according to GitHub (still has the grey checkmark here and in other PRs). This has been the case for a while but I wasn't sure if it was intentional or not, if I mixed something up with adding myself as a codeowner I can try to fix it.

It's nothing wrong on your side, the green check mark is reserved for approvers and maintainers of the project, unrelated to code owners. Code owners are automatically added as reviewers on PRs, and we can also manually check the .github/CODEOWNERS file to see if someone is a code owner for a given component. (For reference, here's a recent PR where code owner approved and they also don't have a green check mark, just to confirm it's not you.)

I see you also requested a review from @dmitryax, but given this is only a documentation change, I assume we're good to merge. Is that accurate, or would you still prefer a review?

@braydonk
Copy link
Contributor

Thanks for the clarification; I was used to other repos where approvals from CODEOWNERS were green check so I wasn't sure.

I thought merging would be blocked by Dmitrii's review; if it wouldn't be, then I imagine this is fine to merge.

@crobert-1
Copy link
Member

I thought merging would be blocked by Dmitrii's review; if it wouldn't be, then I imagine this is fine to merge.

One code owner approval is just fine by default, especially for something simple like this that's only documentation. That being said, if you're ever unsure about a change or want specific feedback from another code owner we can definitely block and ask for more input 👍

@codeboten codeboten merged commit 88a778f into open-telemetry:main Jul 22, 2024
216 of 235 checks passed
@github-actions github-actions bot added this to the next release milestone Jul 22, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation ready to merge Code review completed; ready to merge by maintainers receiver/hostmetrics Skip Changelog PRs that do not require a CHANGELOG.md entry
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Document the mute_process_*_error configuration options available in the process scraper
6 participants