import "golang.org/x/tools/internal/stack"
Package stack provides support for parsing standard goroutine stack traces.
Process and input stream to an output stream, summarizing any stacks that are detected in place.
type Call struct { Stack Stack // the shared callstack information Groups []Group // the sets of goroutines with the same state }
Call is set of goroutines that all share the same callstack. They will be grouped by state.
type Delta struct { Before Dump // The goroutines that were only in the before set. Dump // The goroutines that were in both sets. After Dump // The goroutines that were only in the after set. }
Delta represents the difference between two stack dumps.
Diff calculates the delta between two dumps.
Dump is a raw set of goroutines and their stacks.
Capture get the current stack traces from the runtime.
Parse the current contiguous block of goroutine stack traces until the scanned content no longer matches.
Frame is a point in a call stack.
type Function struct { Package string // package name of function if known Type string // if set function is a method of this type Name string // function name of the frame }
Function is the function called at a frame.
type Goroutine struct { State string // state that the goroutine is in. ID int // id of the goroutine. Stack Stack // call frames that make up the stack }
Goroutine is a single parsed goroutine dump.
type Group struct { State string // the shared state of the goroutines Goroutines []Goroutine // the set of goroutines in this group }
Group is a set of goroutines with the same stack that are in the same state.
Position is the file position for a frame.
type Scanner struct {
// contains filtered or unexported fields
}
Scanner splits an input stream into lines in a way that is consumable by the parser.
NewScanner creates a scanner on top of a reader.
Done returns true if the scanner has reached the end of the underlying stream.
Err returns true if the scanner has reached the end of the underlying stream.
Match returns the submatchs of the regular expression against the next line. If it matched the line is also consumed.
Next consumes and returns the next line.
Peek returns the next line without consuming it.
Skip consumes the next line without looking at it. Normally used after it has already been looked at using Peek.
SkipBlank skips any number of pure whitespace lines.
Stack is a set of frames in a callstack.
type Summary struct { Total int // the total count of goroutines in the summary Calls []Call // the collated stack traces }
Summary is a set of stacks processed and collated into Calls.
Summarize a dump for easier consumption. This collates goroutines with equivalent stacks.
Path | Synopsis |
---|---|
gostacks | The gostacks command processes stdin looking for things that look like stack traces and simplifying them to make the log more readable. |
stacktest |
Package stack imports 10 packages (graph) and is imported by 4 packages. Updated 2021-01-23. Refresh now. Tools for package owners.