A goroutine monitor to keep track of active routines from within your favorite shell.
- Track live state of all active goroutines
- Terminal user interface written with termui 🤓
- Simple to integrate pprof server for live monitoring
- Dynamic history of goroutine count
- Full-text filtering
- Overview of routine states
go install github.com/becheran/roumon@latest
Or download the pre-compiled binaries from the releases page.
Before starting roumon, the go app which shall be monitored needs to be prepared to export pprof infos via http.
The program which shall be monitored needs to run a pprof server.
Import pprof into you program:
import _ "net/http/pprof"
Run a webserver which will listen on a specific port:
go func() {
log.Println(http.ListenAndServe("localhost:6060", nil))
}()
Start your program and check that the pprof
site is available in you web-browser: http://localhost:6060/debug/pprof
Start roumon in from your command line interface. Use optional arguments if needed.
For example roumon -debug=logfile -host=192.168.10.1 -port=8081
will start the routine monitor for the pprof profiles exposed to 192.168.10.1:8081
and write a debug logfile to ./logfile
.
Run roumon with -h
or --help
to see all commandline argument options:
Usage of roumon:
-debug string
Path to debug file
-host string
The pprof server IP or hostname (default "localhost")
-port int
The pprof server port (default 6060)
From within the Terminal User Interface (TUI) hit F1
for help F10
or ctrl-c
to stop the application.
Pull requests and issues are welcome!