Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/bcicen/grmon

Command line monitoring for goroutines
https://github.com/bcicen/grmon

cli command-line developer-tools go golang top

Last synced: 11 days ago
JSON representation

Command line monitoring for goroutines

Lists

README 

        
# grmon



Command line monitoring for goroutines



grmon



## Install



```bash

go get -u github.com/bcicen/grmon

```



## Usage



Simply import and call `grmon.Start()` somewhere in your code:



```go

import "github.com/bcicen/grmon/agent"

...

grmon.Start()

```



alternatively, you may just start the pprof server directly:



```go

import (

	"net/http"

	_ "net/http/pprof"

)

...

go http.ListenAndServe(":1234", nil)

```



now `grmon` can connect to the running program:

```bash

grmon

```



By default, `grmon` will automatically refresh every 5s. Pause automatic refresh(`p`) to enable the cursor and expand the full trace for a selected goroutine(``).



### Keybindings



Key | Action

--- | ---

r | manually refresh

p | pause/unpause automatic updates

s | toggle sort column and refresh

f | filter by keyword

\,\,j,k | move cursor position

\,o | expand trace under cursor

t | open trace in full screen mode

q | exit grmon



### Options



Option | Description | Default

--- | --- | ---

-i | time in seconds between refresh, 0 to disable | 5

-host | target host | localhost:1234

-endpoint	| target endpoint path | /debug/pprof



## Roadmap



* Hierarchal/tree display