Skip to content

Conversation

korniltsev
Copy link
Contributor

@korniltsev korniltsev marked this pull request as ready for review December 13, 2023 09:43
@korniltsev korniltsev requested review from a team as code owners December 13, 2023 09:43
| path | string | The path to the profile type on the target. | "/debug/pprof/delta_heap" | no |

### `profile.godeltaprof_mutex`
### Prepare Grafana Agent Flow configuration file
Copy link
Contributor

Choose a reason for hiding this comment

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

❤️

Or if you use gorilla/mux:
```go
var router *mux.Router
router.PathPrefix("/debug/pprof").Handler(http.DefaultServeMux)
```

Copy link
Contributor

Choose a reason for hiding this comment

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

What are the next steps for someone? is there a page that we can link them to for the next step in what they need to do? (Or maybe we need to write one?)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

not sure I understand your question. The last steps are: see profiles in browser, optimize your application, repeat

Copy link
Contributor

Choose a reason for hiding this comment

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

Sometimes there is a series of tasks you need to do. Those tasks may be on multiple pages. The "next step" can be a link to the procedure the user needs to perform next. if that isn't the case here, then we don't need a link to another page.

However, if there are things a user should repeat to refine the results, we might want to mention that.

Copy link
Contributor

@knylander-grafana knylander-grafana left a comment

Choose a reason for hiding this comment

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

Approving with some minor suggested chagnes.

korniltsev and others added 3 commits December 14, 2023 10:38
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
korniltsev and others added 2 commits December 14, 2023 10:40
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
korniltsev and others added 6 commits December 14, 2023 10:41
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

and add it to your imports:
### Exposing pprof endpoints
Copy link
Contributor

Choose a reason for hiding this comment

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

Should this be at the end or the beginning? seems like we should have people expose their pprof endpoints and then do the rest of the steps to scrape from them

Copy link
Contributor Author

Choose a reason for hiding this comment

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

There is a step 1 exposing pprof endpoints

And this paragraph is for "advanced" cases when user does not use DefaultServeMux or does use gorila/mux .

Probably this paragraph requires different title

Copy link
Contributor

Choose a reason for hiding this comment

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

either way, I think we should put this next to, if not in, the "exposing pprof endpoints" section. I suspect someone who was looking for this would expect to find it near or in that section

Copy link
Contributor Author

Choose a reason for hiding this comment

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

lets remove it alltogether. I dont want this to be next to the "exposing pprof endpoints" as it complicates it

@knylander-grafana knylander-grafana added the type/docs Improvements for doc docs. Used by Docs team for project management label Dec 14, 2023
Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
@Rperry2174 Rperry2174 merged commit 59ce9aa into main Dec 15, 2023
@Rperry2174 Rperry2174 deleted the gopull-docs branch December 15, 2023 18:15
knylander-grafana added a commit that referenced this pull request Dec 15, 2023
* docs: update go-pull.md

* fix links

* rm comments

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* typo

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

---------

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Ryan Perry <Rperry2174@gmail.com>
knylander-grafana added a commit that referenced this pull request Dec 16, 2023
* Changes from 2855 intro doc

* docs: update go-pull.md (#2844)

* docs: update go-pull.md

* fix links

* rm comments

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* typo

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

---------

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Ryan Perry <Rperry2174@gmail.com>

* Create release notes for v1.2.1 (#2860)

* docs: Add sampling documentation (#2854)

* Add sampling doc

* Tweak wording and layout

* Fix links

* Fix absolute links

* Variety of small tweaks in structure and wording

* docs: Refactor ebpf installation (#2849)

* docs: Refactor ebpf installation

* docs: Refactor ebpf installation

* Remove not useful sections.

* review feedbac

* remove absolute link to grafana.com

* lint

* review feedback

* Add diagram for ebpf

* linted

* Update docs/sources/configure-client/grafana-agent/ebpf/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/configuration/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/configuration/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-docker.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-docker.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-kubernetes.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-kubernetes.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/troubleshooting.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/troubleshooting.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/troubleshooting.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/troubleshooting.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-kubernetes.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

---------

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Ryan Perry <Rperry2174@gmail.com>

* docs: language SDK page updates (#2851)

* docs changes

* improvements

* wip

* fixes

* fixes

* fixes

* Update docs/sources/configure-client/language-sdks/go_push.md

* Update docs/sources/configure-client/language-sdks/go_push.md

* Apply suggestions from code review

* Update Before you begin sections

---------

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <kim.nylander@grafana.com>

* doc: Add sampling diagram (#2861)

---------

Co-authored-by: Tolya Korniltsev <korniltsev.anatoly@gmail.com>
Co-authored-by: Ryan Perry <Rperry2174@gmail.com>
Co-authored-by: Bryan Huhta <32787160+bryanhuhta@users.noreply.github.com>
Co-authored-by: Cyril Tovena <cyril.tovena@gmail.com>
Co-authored-by: Dmitry Filimonov <dmitry.filimonov@grafana.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type/docs Improvements for doc docs. Used by Docs team for project management
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants