Skip to content

Commit

Permalink
debug: document the debug script
Browse files Browse the repository at this point in the history
fixes #6457
  • Loading branch information
Stebalien committed Jul 8, 2019
1 parent 2198bf3 commit 20f7ce8
Showing 1 changed file with 5 additions and 4 deletions.
9 changes: 5 additions & 4 deletions docs/debug-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,11 @@ When you see ipfs doing something (using lots of CPU, memory, or otherwise
being weird), the first thing you want to do is gather all the relevant
profiling information.

There's a script (`bin/collect-profiles.sh`) that will do this for you and
bundle the results up into a tarball, ready to be attached to a bug report.

If you feel intrepid, you can dump this information and investigate it yourself:

- goroutine dump
- `curl localhost:5001/debug/pprof/goroutine\?debug=2 > ipfs.stacks`
- 30 second cpu profile
Expand All @@ -26,10 +31,6 @@ profiling information.
- system information
- `ipfs diag sys > ipfs.sysinfo`

Bundle all that up and include a copy of the ipfs binary that you are running
(having the exact same binary is important, it contains debug info).

You can investigate yourself if you feel intrepid:

### Analyzing the stack dump

Expand Down

0 comments on commit 20f7ce8

Please sign in to comment.