Package raw provides an interface to interpret and emit Go execution traces.

MakeResourceID creates a general resource ID from a specific resource's ID.

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.

NewReader creates a new trace reader.

NewSummarizer creates a new struct to build goroutine stats from a trace.

RelatedGoroutinesV2 finds a set of goroutines related to goroutine goid for v2 traces.

BackgroundTask is the global task that events are attached to if there was no other task in the context at the point the event was emitted.

Event types in the trace.

Event types in the trace.

Event types in the trace.

EventExperimental is an experimental event that is unvalidated and exposed in a raw form.

EventLabel attaches a label to a resource.

EventLog represents a runtime/trace.Log call.

EventMetric is an event that represents the value of a metric at a particular point in time.

EventRangeBegin and EventRangeEnd are a pair of generic events representing a special range of time.

EventRegionBegin and EventRegionEnd are a pair of events represent a runtime/trace.Region.

EventStackSample represents an execution sample, indicating what a thread/proc/goroutine was doing at a particular point in time via its backtrace.

EventStateTransition represents a state change for some resource.

EventKindSync is an event that indicates a global synchronization point in the trace.

EvTaskBegin and EvTaskEnd are a pair of events representing a runtime/trace.Task.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Event types in the trace.

Special P identifiers:.

NoGoroutine indicates that the relevant events don't correspond to any goroutine in particular.

NoProc indicates that the relevant events don't correspond to any P in particular.

NoTask indicates the lack of a task.

NoThread indicates that the relevant events don't correspond to any thread in particular.

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.

NoStack is a sentinel value that can be compared against any Stack value, indicating a lack of a stack trace.

Event represents a single event in the trace.

ExperimentalBatch represents a packet of unparsed data along with metadata about that packet.

ExperimentalData represents some raw and unparsed sidecar data present in the trace that is associated with certain kinds of experimental events.

ExperimentalEvent presents a raw view of an experimental event's arguments and thier names.

Frame is a frame in stack traces.

GoroutineExecStats contains statistics about a goroutine's execution during a period of time.

GoroutineSummary contains statistics and execution details of a single goroutine.

Label provides details about a Label event.

Log provides details about a Log event.

Metric provides details about a Metric event.

An MMUCurve is the minimum mutator utilization curve across multiple window sizes.

MutatorUtil is a change in mutator utilization at a particular time.

Range provides details about a Range event.

RangeAttributes provides attributes about a completed Range.

Reader reads a byte stream, validates it, and produces trace events.

Region provides details about a Region event.

ResourceID represents a generic resource ID.

Stack represents a stack.

StackFrame represents a single frame of a stack.

StateTransition provides details about a StateTransition event.

Summarizer constructs per-goroutine time statistics for v2 traces.

Summary is the analysis result produced by the summarizer.

Task provides details about a Task event.

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.

Value is a dynamically-typed value obtained from a trace.

EventKind indicates the kind of event this is.

GoID is the runtime-internal G structure's goid field.

GoState represents the state of a goroutine.

ProcID is the runtime-internal G structure's id field.

ProcState represents the state of a proc.

ResourceKind indicates a kind of resource that has a state machine.

TaskID is the internal ID of a task used to disambiguate tasks (even if they are of the same type).

ThreadID is the runtime-internal M structure's ID.

Time is a timestamp in nanoseconds.

UtilFlags controls the behavior of MutatorUtilization.

ValueKind is the type of a dynamically-typed value from a trace.