aboutsummaryrefslogtreecommitdiff
path: root/doc/diagnostics.html
AgeCommit message (Collapse)Author
2021-02-16doc: remove all docs not tied to distributionRuss Cox
They have moved to x/website in CL 291693. The docs that are left are the ones that are edited at the same time as development in this repository and are tied to the specific version of Go being developed. Those are: - the language spec - the memory model - the assembler manual - the current release's release notes Change-Id: I437c4d33ada1b1716b1919c3c939c2cacf407e83 Reviewed-on: https://go-review.googlesource.com/c/go/+/291711 Trust: Russ Cox <rsc@golang.org> Trust: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-11-20doc: fix misspelling of “initialization” in diagnostics.htmlHollow Man
initilization -> initialization Change-Id: Ie5edd30559941f2d044280d8d586c2c2692d5b69 GitHub-Last-Rev: 7495a8c7227bc9c574c93861e5fedc1bada0397c GitHub-Pull-Request: golang/go#42749 Reviewed-on: https://go-review.googlesource.com/c/go/+/272026 Reviewed-by: Emmanuel Odeke <emmanuel@orijtech.com> Trust: Ian Lance Taylor <iant@golang.org>
2020-10-14runtime: implement GODEBUG=inittrace=1 supportMartin Möhrmann
Setting inittrace=1 causes the runtime to emit a single line to standard error for each package with init work, summarizing the execution time and memory allocation. The emitted debug information for init functions can be used to find bottlenecks or regressions in Go startup performance. Packages with no init function work (user defined or compiler generated) are omitted. Tracing plugin inits is not supported as they can execute concurrently. This would make the implementation of tracing more complex while adding support for a very rare use case. Plugin inits can be traced separately by testing a main package importing the plugins package imports explicitly. $ GODEBUG=inittrace=1 go test init internal/bytealg @0.008 ms, 0 ms clock, 0 bytes, 0 allocs init runtime @0.059 ms, 0.026 ms clock, 0 bytes, 0 allocs init math @0.19 ms, 0.001 ms clock, 0 bytes, 0 allocs init errors @0.22 ms, 0.004 ms clock, 0 bytes, 0 allocs init strconv @0.24 ms, 0.002 ms clock, 32 bytes, 2 allocs init sync @0.28 ms, 0.003 ms clock, 16 bytes, 1 allocs init unicode @0.44 ms, 0.11 ms clock, 23328 bytes, 24 allocs ... Inspired by stapelberg@google.com who instrumented doInit in a prototype to measure init times with GDB. Fixes #41378 Change-Id: Ic37c6a0cfc95488de9e737f5e346b8dbb39174e1 Reviewed-on: https://go-review.googlesource.com/c/go/+/254659 Trust: Martin Möhrmann <moehrmann@google.com> Run-TryBot: Martin Möhrmann <moehrmann@google.com> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Keith Randall <khr@golang.org>
2018-12-18doc: document GODEBUG options to disable use of instruction set extensionsMartin Möhrmann
Fixes #27218 Change-Id: I4eb8e8f2486b20fe0ed6e3e2c6ec521c9e8c0032 Reviewed-on: https://go-review.googlesource.com/c/149579 Reviewed-by: Austin Clements <austin@google.com>
2018-06-17doc: update more stale pprof linksMostyn Bramley-Moore
Related to #25477. Change-Id: I11261c6055b446ceca1b3acc538ab00fec4b47ca Reviewed-on: https://go-review.googlesource.com/119321 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2018-02-12all: restore changes from faulty merge/revertAndrew Bonventre
This reverts commit 3b6abd8a4501d816e80b4d46e6fda4df486ccb66. Change-Id: I8ca100501c1844af78a547989786d14dac6b494a Reviewed-on: https://go-review.googlesource.com/93456 Reviewed-by: Andrew Bonventre <andybons@golang.org>
2018-02-12Revert "[release-branch.go1.10] all: merge master into release-branch.go1.10"Andrew Bonventre
This reverts commit b83d7f72537bdc0cec2e949d73ae40fbd42b7c63. Reason for revert: wrong branch Change-Id: I28ebb121f7b3e331729e8a6a00961b876f3dd0f2 Reviewed-on: https://go-review.googlesource.com/93455 Reviewed-by: Andrew Bonventre <andybons@golang.org>
2018-02-09doc: minor wording improvement to the diagnostics guideJBD
Change-Id: I8469fbbb934f096f04ad68c592aacdb805b6d2d4 GitHub-Last-Rev: 6d2cfcc23d0d8e6a1b6ca383dae51f0cada2e1b3 GitHub-Pull-Request: golang/go#23754 Reviewed-on: https://go-review.googlesource.com/92996 Reviewed-by: Andrew Bonventre <andybons@golang.org>
2018-02-05doc/editors: remove feature matrix for various editors/IDEsAndrew Bonventre
The speed of feature development for these products outpaces the standard Go 6-month release cycle tied to this page. The cost of maintaining this list is becoming a burden as we make every attempt at being impartial. As of this writing, we believe feature lists belong on the pages of the editors/IDEs themselves. Change-Id: Ie2dfe0e0d47d203c913373e58cbb65cb0fb14d0c Reviewed-on: https://go-review.googlesource.com/91976 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2018-01-09doc: remove interior <code> spaces in debugging, diagnostics docsRuss Cox
Change-Id: I20de6207d386635025dbb603c57219218e9a9af5 Reviewed-on: https://go-review.googlesource.com/87019 Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2018-01-04doc/diagnostics: update gc flags recommended for debuggingHana Kim
After 1.10, gcflags apply to only the immediate target. Change-Id: I3bf331c76041e7b533076cb2f3274e44aafff58a Reviewed-on: https://go-review.googlesource.com/84775 Reviewed-by: Heschi Kreinick <heschi@google.com>
2017-12-14doc: make it clear which pprof package is usedJBD
Updates #22027. Change-Id: I5a5bae77a744c7a2ecb75172846e6461a98ee8af Reviewed-on: https://go-review.googlesource.com/83916 Reviewed-by: Andrew Bonventre <andybons@golang.org>
2017-12-14doc: add some links to the diagnostics pageJBD
Updates #22027. Change-Id: I468348d2b000f146f88ef8b7cf450eea8d1c12a7 Reviewed-on: https://go-review.googlesource.com/83917 Reviewed-by: Andrew Bonventre <andybons@golang.org>
2017-12-13doc: update info about flame graphs in diagnostics.htmlHana Kim
Use Brendan Gregg's FlameGraphs page link. Mention the flame graph is available from the upstream pprof. Change-Id: Ife1d5a5f4f93f20cd5952a09083f798b77d25a60 Reviewed-on: https://go-review.googlesource.com/83798 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2017-11-21doc: fix some typos in diagnostics.htmlReilly Watson
The section about custom pprof paths referenced the wrong path. This also fixes a couple minor grammatical issues elsewhere in the doc. Fixes #22832 Change-Id: I890cceb53a13c1958d9cf958c658ccfcbb6863d5 Reviewed-on: https://go-review.googlesource.com/79035 Reviewed-by: Alberto Donizetti <alb.donizetti@gmail.com>
2017-09-12doc: unify colons and spacing in diagnostics guideTobias Klauser
Unify colons (outside of <strong></strong>) and add a missing space in the list of groups of diagnostics solutions. Change-Id: Icbcd94427d4905dd88c4ea82aaa5dbf064c00990 Reviewed-on: https://go-review.googlesource.com/63111 Reviewed-by: JBD <jbd@google.com>
2017-09-11doc: fix typo in the diagnostics guideJaana Burcu Dogan
Change-Id: Ib1b93e55788168b574badeb84d0e6c4f3795055e Reviewed-on: https://go-review.googlesource.com/62510 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2017-09-08doc: add a diagnostics guideJaana Burcu Dogan
Diagnostics guide lists various dimensions of diagnostics tools and libraries available in Go. As a follow-up, I will add an entry section where we navigate user to the right tool depending on the type of problem they are willing to improve or understand better. Change-Id: I4e94b4b834014f51c988103457da84200c7827d9 Reviewed-on: https://go-review.googlesource.com/61693 Reviewed-by: Hyang-Ah Hana Kim <hyangah@gmail.com>