grstates

Documentation

Overview

The grstates command shows the goroutine state machines from a program's execution trace

An execution trace, collected with the runtime/trace package, describes all of the times a program's goroutines interacted with the scheduler: when they make syscalls (to read or write network data), when they launch or unblock other goroutines, when they need to wait on a channel or a lock.

By watching a goroutine throughout its lifecycle as the functions on its call stack change, we can build a view of its actions as a state machine.

This tool processes an execution trace into a directed graph in the DOT language and rendered as an SVG, via the same "dot" tool that "go tool pprof" uses.