package
1.22.2
Repository: https://github.com/go-asm/go.git
Documentation: pkg.go.dev

# Packages

No description provided by the author
No description provided by the author

# Functions

GoroutineStats generates statistics for all goroutines in the trace.
No description provided by the author
MutatorUtilization returns a set of mutator utilization functions for the given trace.
MutatorUtilizationV2 returns a set of mutator utilization functions for the given v2 trace, passed as an io.Reader.
NewMMUCurve returns an MMU curve for the given mutator utilization function.
NewSummarizer creates a new struct to build goroutine stats from a trace.
No description provided by the author
Parse parses, post-processes and verifies the trace.
Print dumps events to stdout.
PrintEvent dumps the event to stdout.
No description provided by the author
RelatedGoroutines finds a set of goroutines related to goroutine goid.
RelatedGoroutinesV2 finds a set of goroutines related to goroutine goid for v2 traces.

# Constants

start of per-P batch of events [pid, timestamp].
Event types in the trace.
CPU profiling sample [timestamp, real timestamp, real P id (-1 when absent), goroutine id, stack].
contains tracer timer frequency [frequency (ticks per second)].
denotes that the previous wakeup of this goroutine was futile [timestamp].
GC done [timestamp].
GC mark assist done [timestamp].
GC mark assist start [timestamp, stack].
GC start [timestamp, seq, stack id].
GC sweep done [timestamp, swept, reclaimed].
GC sweep start [timestamp, stack id].
goroutine blocks [timestamp, stack].
goroutine blocks on Cond [timestamp, stack].
goroutine blocks on GC assist [timestamp, stack].
goroutine blocks on network [timestamp, stack].
goroutine blocks on chan recv [timestamp, stack].
goroutine blocks on select [timestamp, stack].
goroutine blocks on chan send [timestamp, stack].
goroutine blocks on Mutex/RWMutex [timestamp, stack].
goroutine creation [timestamp, new goroutine id, new stack id, stack id].
goroutine ends [timestamp].
denotes that goroutine is in syscall when tracing starts [timestamp, goroutine id].
current value of GOMAXPROCS [timestamp, GOMAXPROCS, stack id].
goroutine is preempted [timestamp, stack].
goroutine calls Gosched [timestamp, stack].
goroutine calls Sleep [timestamp, stack].
goroutine starts running [timestamp, goroutine id, seq].
goroutine starts running with label [timestamp, goroutine id, seq, label string id].
goroutine starts running on the same P as the last event [timestamp, goroutine id].
goroutine stops (like in select{}) [timestamp, stack].
syscall blocks [timestamp].
syscall enter [timestamp, stack].
syscall exit [timestamp, goroutine id, seq, real timestamp].
syscall exit on the same P as the last event [timestamp, goroutine id, real timestamp].
goroutine is unblocked [timestamp, goroutine id, seq, stack].
goroutine is unblocked on the same P as the last event [timestamp, goroutine id, stack].
denotes that goroutine is blocked when tracing starts [timestamp, goroutine id].
gcController.heapLive change [timestamp, heap live bytes].
gcController.heapGoal change [timestamp, heap goal bytes].
unused.
start of P [timestamp, thread id].
stop of P [timestamp].
stack [stack id, number of PCs, array of {PC, func string ID, file string ID, line}].
string dictionary entry [ID, length, string].
GC mark termination done [timestamp].
GC mark termination start [timestamp, kind].
denotes timer goroutine [timer goroutine id].
trace.Log [timestamp, internal id, key string id, stack, value string].
trace.WithRegion [timestamp, internal task id, mode(0:start, 1:end), name string, stack].
trace.NewTask [timestamp, internal task id, internal parent id, name string, stack].
end of task [timestamp, internal task id, stack].
Special P identifiers:.
depicts GC state.
depicts network unblocks.
depicts recording of CPU profile samples.
depicts returns from syscalls.
depicts timer unblocks.
UtilAssist means utilization should account for mark assists.
UtilBackground means utilization should account for background mark workers.
UtilPerProc means each P should be given a separate utilization function.
UtilSTW means utilization should account for STW events.
UtilSweep means utilization should account for sweeping.

# Variables

BreakTimestampsForTesting causes the parser to randomly alter timestamps (for testing of broken cputicks).
ErrTimeOrder is returned by Parse when the trace contains time stamps that do not respect actual event ordering.
No description provided by the author

# Structs

Event describes one event in the trace.
Frame is a frame in stack traces.
GDesc contains statistics and execution details of a single goroutine.
GExecutionStat contains statistics about a goroutine's execution during a period of time.
GoroutineExecStats contains statistics about a goroutine's execution during a period of time.
GoroutineSummary contains statistics and execution details of a single goroutine.
An MMUCurve is the minimum mutator utilization curve across multiple window sizes.
MutatorUtil is a change in mutator utilization at a particular time.
ParseResult is the result of Parse.
Summarizer constructs per-goroutine time statistics for v2 traces.
Summary is the analysis result produced by the summarizer.
UserRegionDesc represents a region and goroutine execution stats while the region was active.
UserRegionSummary represents a region and goroutine execution stats while the region was active.
UserTaskSummary represents a task in the trace.
UtilWindow is a specific window at Time.
Writer is a test trace writer.

# Type aliases

UtilFlags controls the behavior of MutatorUtilization.