type Demangler func(name []string) (map[string]string,error)

type Edge struct {Src, Dest *Node// The summary weight of the edgeWeight, WeightDivint64// residual edges connect nodes that were connected through a// separate node, which has been removed from the report.Residualbool// An inline edge represents a call that was inlined into the caller.Inlinebool}

func (*Edge)WeightValue¶added ingo1.23.0

func (e *Edge) WeightValue()int64

WeightValue returns the weight value for this edge, normalizing if adivisor is available.

type EdgeMap []*Edge

func (*EdgeMap)Add¶added ingo1.23.0

func (em *EdgeMap) Add(e *Edge)

func (*EdgeMap)Delete¶added ingo1.23.0

func (em *EdgeMap) Delete(e *Edge)

func (EdgeMap)FindTo¶added ingo1.23.0

func (emEdgeMap) FindTo(n *Node) *Edge

func (EdgeMap)Sort¶added ingo1.23.0

func (emEdgeMap) Sort() []*Edge

Sort returns a slice of the edges in the map, in a consistentorder. The sort order is first based on the edge weight(higher-to-lower) and then by the node names to avoid flakiness.

func (EdgeMap)Sum¶added ingo1.23.0

func (emEdgeMap) Sum()int64

Sum returns the total weight for a set of nodes.

type Function struct {IDuint64NamestringSystemNamestringFilenamestringStartLineint64// contains filtered or unexported fields}

type Graph struct {NodesNodes}

funcNewGraph¶added ingo1.23.0

func NewGraph(prof *Profile, o *Options) *Graph

NewGraph computes a graph from a profile.

func (*Graph)String¶added ingo1.23.0

func (g *Graph) String()string

String returns a text representation of a graph, for debugging purposes.

type Label struct {// contains filtered or unexported fields}

type Line struct {Function *FunctionLineint64// contains filtered or unexported fields}

type Location struct {IDuint64Mapping  *MappingAddressuint64Line     []LineIsFoldedbool// contains filtered or unexported fields}

type Mapping struct {IDuint64Startuint64Limituint64Offsetuint64FilestringBuildIDstringHasFunctionsboolHasFilenamesboolHasLineNumbersboolHasInlineFramesbool// contains filtered or unexported fields}

type Node struct {// Info describes the source location associated to this node.InfoNodeInfo// Function represents the function that this node belongs to. On// graphs with sub-function resolution (eg line number or// addresses), two nodes in a NodeMap that are part of the same// function have the same value of Node.Function. If the Node// represents the whole function, it points back to itself.Function *Node// Values associated to this node. Flat is exclusive to this node,// Cum includes all descendents.Flat, FlatDiv, Cum, CumDivint64// In and out Contains the nodes immediately reaching or reached by// this node.In, OutEdgeMap}

func (*Node)AddToEdge¶added ingo1.23.0

func (n *Node) AddToEdge(to *Node, vint64, residual, inlinebool)

AddToEdge increases the weight of an edge between two nodes. Ifthere isn't such an edge one is created.

func (*Node)AddToEdgeDiv¶added ingo1.23.0

func (n *Node) AddToEdgeDiv(to *Node, dv, vint64, residual, inlinebool)

AddToEdgeDiv increases the weight of an edge between two nodes. Ifthere isn't such an edge one is created.

func (*Node)CumValue¶added ingo1.23.0

func (n *Node) CumValue()int64

CumValue returns the inclusive value for this node, computing themean if a divisor is available.

func (*Node)FlatValue¶added ingo1.23.0

func (n *Node) FlatValue()int64

FlatValue returns the exclusive value for this node, computing themean if a divisor is available.

type NodeInfo struct {NamestringAddressuint64StartLine, Linenoint}

func (*NodeInfo)NameComponents¶added ingo1.23.0

func (i *NodeInfo) NameComponents() []string

NameComponents returns the components of the printable name to be used for a node.

func (*NodeInfo)PrintableName¶added ingo1.23.0

func (i *NodeInfo) PrintableName()string

PrintableName calls the Node's Formatter function with a single space separator.

type NodeMap map[NodeInfo]*Node

func (NodeMap)FindOrInsertNode¶added ingo1.23.0

func (nmNodeMap) FindOrInsertNode(infoNodeInfo, keptNodeSet) *Node

FindOrInsertNode takes the info for a node and either returns a matching nodefrom the node map if one exists, or adds one to the map if one does not.If kept is non-nil, nodes are only added if they can be located on it.

type NodePtrSet map[*Node]bool

type NodeSet map[NodeInfo]bool

type Nodes []*Node

funcCreateNodes¶added ingo1.23.0

func CreateNodes(prof *Profile, o *Options) (Nodes, locationMap)

CreateNodes creates graph nodes for all locations in a profile. Itreturns set of all nodes, plus a mapping of each location to theset of corresponding nodes (one per location.Line).

func (Nodes)Sum¶added ingo1.23.0

func (nsNodes) Sum() (flatint64, cumint64)

Sum adds the flat and cum values of a set of nodes.

type Options struct {SampleValue       func(s []int64)int64// Function to compute the value of a sampleSampleMeanDivisor func(s []int64)int64// Function to compute the divisor for mean graphs, or nilDropNegativebool// Drop nodes with overall negative valuesKeptNodesNodeSet// If non-nil, only use nodes in this set}

type Profile struct {SampleType        []*ValueTypeDefaultSampleTypestringSample            []*SampleMapping           []*MappingLocation          []*LocationFunction          []*FunctionComments          []stringDropFramesstringKeepFramesstringTimeNanosint64DurationNanosint64PeriodType    *ValueTypePeriodint64// contains filtered or unexported fields}

funcMerge¶

func Merge(srcs []*Profile) (*Profile,error)

Merge merges all the profiles in profs into a single Profile.Returns a new profile independent of the input profiles. The mergedprofile is compacted to eliminate unused samples, locations,functions and mappings. Profiles must have identical profile sampleand period types or the merge will fail. profile.Period of theresulting profile will be the maximum of all profiles, andprofile.TimeNanos will be the earliest nonzero one.

funcParse¶

func Parse(rio.Reader) (*Profile,error)

Parse parses a profile and checks for its validity. The input must be anencoded pprof protobuf, which may optionally be gzip-compressed.

func (*Profile)Aggregate¶

func (p *Profile) Aggregate(inlineFrame, function, filename, linenumber, addressbool)error

Aggregate merges the locations in the profile into equivalenceclasses preserving the request attributes. It also updates thesamples to point to the merged locations.

func (*Profile)CheckValid¶

func (p *Profile) CheckValid()error

CheckValid tests whether the profile is valid. Checks include, but arenot limited to:

• len(Profile.Sample[n].value) == len(Profile.value_unit)
• Sample.id has a corresponding Profile.Location

func (*Profile)Compatible¶

func (p *Profile) Compatible(pb *Profile)error

Compatible determines if two profiles can be compared/merged.returns nil if the profiles are compatible; otherwise an error withdetails on the incompatibility.

func (*Profile)Copy¶

func (p *Profile) Copy() *Profile

Copy makes a fully independent copy of a profile.

func (*Profile)Demangle¶

func (p *Profile) Demangle(dDemangler)error

Demangle attempts to demangle and optionally simplify any functionnames referenced in the profile. It works on a best-effort basis:it will silently preserve the original names in case of any errors.

func (*Profile)Empty¶

func (p *Profile) Empty()bool

Empty reports whether the profile contains no samples.

func (*Profile)FilterSamplesByTag¶

func (p *Profile) FilterSamplesByTag(focus, ignoreTagMatch) (fm, imbool)

FilterSamplesByTag removes all samples from the profile, exceptthose that match focus and do not match the ignore regularexpression.

func (*Profile)HasFileLines¶

func (p *Profile) HasFileLines()bool

HasFileLines determines if all locations in this profile havesymbolized file and line number information.

func (*Profile)HasFunctions¶

func (p *Profile) HasFunctions()bool

HasFunctions determines if all locations in this profile havesymbolized function information.

func (*Profile)Merge¶

func (p *Profile) Merge(pb *Profile, rfloat64)error

Merge adds profile p adjusted by ratio r into profile p. Profilesmust be compatible (same Type and SampleType).TODO(rsilvera): consider normalizing the profiles based on thetotal samples collected.

func (*Profile)Normalize¶

func (p *Profile) Normalize(pb *Profile)error

Normalize normalizes the source profile by multiplying each value in profile by theratio of the sum of the base profile's values of that sample type to the sum of thesource profile's value of that sample type.

func (*Profile)Prune¶

func (p *Profile) Prune(dropRx, keepRx *regexp.Regexp)

Prune removes all nodes beneath a node matching dropRx, and notmatching keepRx. If the root node of a Sample matches, the samplewill have an empty stack.

func (*Profile)RemoveUninteresting¶

func (p *Profile) RemoveUninteresting()error

RemoveUninteresting prunes and elides profiles using built-intables of uninteresting function names.

func (*Profile)Scale¶

func (p *Profile) Scale(ratiofloat64)

Scale multiplies all sample values in a profile by a constant.

func (*Profile)ScaleN¶

func (p *Profile) ScaleN(ratios []float64)error

ScaleN multiplies each sample values in a sample by a different amount.

func (*Profile)String¶

func (p *Profile) String()string

Print dumps a text representation of a profile. Intended mainlyfor debugging purposes.

func (*Profile)Write¶

func (p *Profile) Write(wio.Writer)error

Write writes the profile as a gzip-compressed marshaled protobuf.

type Sample struct {Location []*LocationValue    []int64Label    map[string][]stringNumLabel map[string][]int64NumUnit  map[string][]string// contains filtered or unexported fields}

type TagMatch func(key, valstring, nvalint64)bool

type ValueType struct {Typestring// cpu, wall, inuse_space, etcUnitstring// seconds, nanoseconds, bytes, etc// contains filtered or unexported fields}