TrueCloudLab/rclone
16
0
Fork 3
Code Issues 3 Pull requests 1 Projects Releases Packages Wiki Activity Actions

rc: improve docs on debugging

Browse source
This commit is contained in:
Nick Craig-Wood 2018-11-10 10:18:13 +00:00
parent 9322f4baef
commit c4b0a37b21
1 changed files with 20 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
docs/content/rc.md
View file

@ -917,7 +917,9 @@ profiling tools on the same port.
To use these, first [install go](https://golang.org/doc/install). To use these, first [install go](https://golang.org/doc/install).
Then (for example) to profile rclone's memory use you can run: ### Debugging memory use
To profile rclone's memory use you can run:
go tool pprof -web http://localhost:5572/debug/pprof/heap go tool pprof -web http://localhost:5572/debug/pprof/heap
@ -944,9 +946,25 @@ Showing nodes accounting for 1537.03kB, 100% of 1537.03kB total
0 0% 100% 1024.03kB 66.62% runtime.main 0 0% 100% 1024.03kB 66.62% runtime.main
``` ```
Possible profiles to look at: ### Debugging go routine leaks
Memory leaks are most often caused by go routine leaks keeping memory
alive which should have been garbage collected.
See all active go routines using
curl http://localhost:5572/debug/pprof/goroutine?debug=1
Or go to http://localhost:5572/debug/pprof/goroutine?debug=1 in your browser.
### Other profiles to look at
You can see a summary of profiles available at http://localhost:5572/debug/pprof/
Here is how to use some of them:
* Memory: `go tool pprof http://localhost:5572/debug/pprof/heap` * Memory: `go tool pprof http://localhost:5572/debug/pprof/heap`
* Go routines: `curl http://localhost:5572/debug/pprof/goroutine?debug=1`
* 30-second CPU profile: `go tool pprof http://localhost:5572/debug/pprof/profile` * 30-second CPU profile: `go tool pprof http://localhost:5572/debug/pprof/profile`
* 5-second execution trace: `wget http://localhost:5572/debug/pprof/trace?seconds=5` * 5-second execution trace: `wget http://localhost:5572/debug/pprof/trace?seconds=5`