profiler

type CallMetrics struct {
	FnName string `json:"fn"`

	// Total time spent in this call.
	TotalTime time.Duration `json:"total_time"`

	// Min and max time.
	MinTime time.Duration `json:"min_time"`
	MaxTime time.Duration `json:"max_time"`

	// Mean and median time.
	MeanTime   time.Duration `json:"mean_time"`
	MedianTime time.Duration `json:"median_time"`

	// Percentiles.
	P50Time time.Duration `json:"p50_time"`
	P75Time time.Duration `json:"p75_time"`
	P90Time time.Duration `json:"p90_time"`
	P99Time time.Duration `json:"p99_time"`

	// Std of time valus.
	StdDev float64 `json:"std_dev"`

	// The number of times a scope was entered by the same parent function call.
	Invocations int `json:"invocations"`

	NestedCalls []*CallMetrics `json:"calls"`
}

type Profile struct {
	ID        uint64    `json:"-"`
	CreatedAt time.Time `json:"-"`

	Label  string       `json:"label"`
	Target *CallMetrics `json:"target"`
}

type Sink interface {
	// Initialize the sink input channel with the specified buffer capacity.
	Open(inputBufferSize int) error

	// Shutdown the sink.
	Close() error

	// Get a channel for piping profile entries to the sink.
	Input() chan<- *Profile
}