Skip to content

[Self managed docs] Document memory profiles and prometheus snapshots in debug tool #32608

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

Open
wants to merge 1 commit into
base: self-managed-docs/v25.1
Choose a base branch
from

Conversation

SangJunBak
Copy link
Contributor

@SangJunBak SangJunBak commented May 29, 2025

sibling pr #32607

Motivation

Tips for reviewer

Checklist

  • This PR has adequate test coverage / QA involvement has been duly considered. (trigger-ci for additional test/nightly runs)
  • This PR has an associated up-to-date design doc, is a design doc (template), or is sufficiently small to not require a design.
  • If this PR evolves an existing $T ⇔ Proto$T mapping (possibly in a backwards-incompatible way), then it is tagged with a T-proto label.
  • If this PR will require changes to cloud orchestration or tests, there is a companion cloud PR to account for those changes that is tagged with the release-blocker label (example).
  • If this PR includes major user-facing behavior changes, I have pinged the relevant PM to schedule a changelog post.

@SangJunBak SangJunBak requested review from a team as code owners May 29, 2025 16:20
@SangJunBak SangJunBak changed the base branch from main to self-managed-docs/v25.1 May 29, 2025 16:20
@SangJunBak SangJunBak requested a review from kay-kim May 29, 2025 16:21
@SangJunBak SangJunBak force-pushed the jun/self-managed/document-mz-debug-new-metrics branch from 92566ce to d4a1586 Compare May 29, 2025 16:56
@@ -0,0 +1,5 @@
### Memory profiles

`mz-debug` outputs heap profiles if
Copy link
Contributor

Choose a reason for hiding this comment

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

Depending on what we want to emphasize, we could flip these sentences as (something like)

By default, mz-debug outputs heap profiles for each service in profiles/{service}.memprof.pprof.gz. To turn off this behavior, you can set --dump-heap-profiles to false.

Copy link
Contributor

Choose a reason for hiding this comment

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

Also, where are these configs doc'ed? I don't see them on the page.

Copy link
Contributor

Choose a reason for hiding this comment

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

I do see them in the main branch version's mz_debug_option.yml though... just an oversight on the self-managed-docs branch

Copy link
Contributor

@kay-kim kay-kim left a comment

Choose a reason for hiding this comment

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

Changing to request changes to fix the links.
The wording change ... I don't have strong opinions.

@@ -0,0 +1,5 @@
### Memory profiles

`mz-debug` outputs heap profiles if
Copy link
Contributor

Choose a reason for hiding this comment

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

Also, where are these configs doc'ed? I don't see them on the page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants