Popularity
4.8
Growing
Activity
5.5
Growing
188
4
8

Programming language: Go
License: MIT License
Tags: Go Tools    

roumon alternatives and similar packages

Based on the "Go Tools" category.
Alternatively, view roumon alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of roumon or a related project?

Add another 'Go Tools' Package

README

roumon

Build Status Go Report Card PRs Welcome License Go Reference Coverage Status

A go*routine **mon*itor to keep track of active routines from within your favorite shell.

[screenshot](doc/Screenshot.png)

Features

  • 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

Installation

go install github.com/becheran/roumon@latest

Or download the pre-compiled binaries from the releases page.

Usage

Before starting roumon, the go app which shall be monitored needs to be prepared to export pprof infos via http.

pprof

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

roumon

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.

Contributing

Pull requests and issues [are welcome](./CONTRIBUTING.md)!


*Note that all licence references and agreements mentioned in the roumon README section above are relevant to that project's source code only.