analysis

package

v0.2.1 Latest Latest Go to latest Published: Aug 4, 2026 License: Apache-2.0 Imports: 8 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

type FunctionStat struct {
	Function   string
	Percentage float64
}

FunctionStat describes one function's flat contribution to a profile.

type ProfileAnalysis struct {
	Type      ProfileType
	Functions []FunctionStat
}

ProfileAnalysis contains the ranked functions for one collected profile.

func AnalyzeProfiles(profiles []*profile.CollectedProfile, limit int) ([]ProfileAnalysis, error)

AnalyzeProfiles returns deterministic, ranked function summaries for the collected profiles. A limit of zero disables analysis.

type ProfileType string

ProfileType maps to pprof profile types for threshold evaluation.

const (
	CPU       ProfileType = "cpu"
	Alloc     ProfileType = "alloc"
	Block     ProfileType = "block"
	Goroutine ProfileType = "goroutine"
)

type Threshold struct {
	Type       ProfileType
	Percentage float64
}

Threshold defines a pass/fail gate for a profile type.

func ParseThresholds(s string) ([]Threshold, error)

ParseThresholds parses a comma-separated threshold string like "cpu:30,alloc:50".

type Violation struct {
	Function   string
	Percentage float64
	Threshold  Threshold
}

Violation records a function that exceeded its threshold.

func CheckThresholds(profiles []*profile.CollectedProfile, thresholds []Threshold) ([]Violation, error)

CheckThresholds evaluates collected profiles against thresholds. Returns violations for functions exceeding their threshold.