package lv

import "github.com/go-kit/kit/metrics/internal/lv"

Index ¶

• type LabelValues
• func (lvs LabelValues) With(labelValues ...string) LabelValues
• type Space
• func NewSpace() *Space
• func (s *Space) Add(name string, lvs LabelValues, delta float64)
• func (s *Space) Observe(name string, lvs LabelValues, value float64)
• func (s *Space) Reset() *Space
• func (s *Space) Walk(fn func(name string, lvs LabelValues, observations []float64) bool)

Types ¶

type LabelValues ¶

type LabelValues []string

LabelValues is a type alias that provides validation on its With method. Metrics may include it as a member to help them satisfy With semantics and save some code duplication.

func (LabelValues) With ¶

func (lvs LabelValues) With(labelValues ...string) LabelValues

With validates the input, and returns a new aggregate labelValues.

type Space ¶

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

Space represents an N-dimensional vector space. Each name and unique label value pair establishes a new dimension and point within that dimension. Order matters, i.e. [a=1 b=2] identifies a different timeseries than [b=2 a=1].

func NewSpace ¶

func NewSpace() *Space

NewSpace returns an N-dimensional vector space.

func (*Space) Add ¶

func (s *Space) Add(name string, lvs LabelValues, delta float64)

Add locates the time series identified by the name and label values in the vector space, and appends the delta to the last value in the list of observations.

func (*Space) Observe ¶

func (s *Space) Observe(name string, lvs LabelValues, value float64)

Observe locates the time series identified by the name and label values in the vector space, and appends the value to the list of observations.

func (*Space) Reset ¶

func (s *Space) Reset() *Space

Reset empties the current space and returns a new Space with the old contents. Reset a Space to get an immutable copy suitable for walking.

func (*Space) Walk ¶

func (s *Space) Walk(fn func(name string, lvs LabelValues, observations []float64) bool)

Walk traverses the vector space and invokes fn for each non-empty time series which is encountered. Return false to abort the traversal.

Source Files ¶

labelvalues.go space.go