meter

Documentation

Overview

Package meter is for instrumentation

Index

• Variables
• func NewContext(ctx context.Context, c Meter) context.Context
• type Counter
• type FloatCounter
• type Gauge
• type Histogram
• type LabelIter
  • func (iter *LabelIter) Next(k, v *string) bool
• type Labels
  • func (ls Labels) Append(nls Labels) Labels
  • func (ls Labels) Iter() *LabelIter
• type Meter
  • func FromContext(ctx context.Context) (Meter, bool)
  • func NewMeter(opts ...Option) Meter
• type Option
  • func Address(value string) Option
  • func Context(ctx context.Context) Option
  • func Label(key, val string) Option
  • func Logger(l logger.Logger) Option
  • func Name(n string) Option
  • func Path(value string) Option
  • func SetOption(k, v interface{}) Option
  • func WriteFDMetrics(b bool) Option
  • func WriteProcessMetrics(b bool) Option
• type Options
  • func NewOptions(opt ...Option) Options
• type Summary

Variables

var (
	// DefaultMeter is the default meter
	DefaultMeter Meter = NewMeter()
	// DefaultAddress data will be made available on this host:port
	DefaultAddress = ":9090"
	// DefaultPath the meter endpoint where the Meter data will be made available
	DefaultPath = "/metrics"
	// DefaultMetricPrefix holds the string that prepends to all metrics
	DefaultMetricPrefix = "micro_"
	// DefaultLabelPrefix holds the string that prepends to all labels
	DefaultLabelPrefix = "micro_"
	// DefaultSummaryQuantiles is the default spread of stats for summary
	DefaultSummaryQuantiles = []float64{0.5, 0.9, 0.97, 0.99, 1}
	// DefaultSummaryWindow is the default window for summary
	DefaultSummaryWindow = 5 * time.Minute
)

Functions

func NewContext

func NewContext(ctx context.Context, c Meter) context.Context

NewContext put meter in context

Types

type Counter

type Counter interface {
	Add(int)
	Dec()
	Get() uint64
	Inc()
	Set(uint64)
}

Counter is a counter

type FloatCounter

type FloatCounter interface {
	Add(float64)
	Get() float64
	Set(float64)
	Sub(float64)
}

FloatCounter is a float64 counter

type Gauge

type Gauge interface {
	Get() float64
}

Gauge is a float64 gauge

type Histogram

type Histogram interface {
	Reset()
	Update(float64)
	UpdateDuration(time.Time)
}

Histogram is a histogram for non-negative values with automatically created buckets

type LabelIter

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

LabelIter holds the

func (*LabelIter) Next

func (iter *LabelIter) Next(k, v *string) bool

Next advance itarator to new pos

type Labels

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

Labels holds the metrics labels with k, v

func (Labels) Append

func (ls Labels) Append(nls Labels) Labels

Append adds labels to label set

func (Labels) Iter

func (ls Labels) Iter() *LabelIter

Iter returns labels iterator

type Meter

type Meter interface {
	Name() string
	Init(opts ...Option) error
	Counter(name string, opts ...Option) Counter
	FloatCounter(name string, opts ...Option) FloatCounter
	Gauge(name string, fn func() float64, opts ...Option) Gauge
	Set(opts ...Option) Meter
	Histogram(name string, opts ...Option) Histogram
	Summary(name string, opts ...Option) Summary
	SummaryExt(name string, window time.Duration, quantiles []float64, opts ...Option) Summary
	Write(w io.Writer, opts ...Option) error
	Options() Options
	String() string
}

Meter is an interface for collecting and instrumenting metrics

func FromContext

func FromContext(ctx context.Context) (Meter, bool)

FromContext get meter from context

func NewMeter

func NewMeter(opts ...Option) Meter

NewMeter returns a configured noop reporter:

type Option

type Option func(*Options)

Option powers the configuration for metrics implementations:

func Address

func Address(value string) Option

Address is the listen address to serve metrics

func Context

func Context(ctx context.Context) Option

Context sets the metrics context

func Label

func Label(key, val string) Option

Label sets the label

func Logger

func Logger(l logger.Logger) Option

Logger sets the logger

func Name

func Name(n string) Option

Name sets the name

func Path

func Path(value string) Option

Path used to serve metrics over HTTP

func SetOption

func SetOption(k, v interface{}) Option

SetOption returns a function to setup a context with given value

func WriteFDMetrics

func WriteFDMetrics(b bool) Option

WriteFDMetrics enable fd metrics output for write

func WriteProcessMetrics

func WriteProcessMetrics(b bool) Option

WriteProcessMetrics enable process metrics output for write

type Options

type Options struct {
	Name    string
	Address string
	Path    string
	Labels  Labels
	//TimingObjectives map[float64]float64
	Logger              logger.Logger
	Context             context.Context
	MetricPrefix        string
	LabelPrefix         string
	WriteProcessMetrics bool
	WriteFDMetrics      bool
}

Options for metrics implementations:

func NewOptions

func NewOptions(opt ...Option) Options

NewOptions prepares a set of options:

type Summary

type Summary interface {
	Update(float64)
	UpdateDuration(time.Time)
}

Summary is the summary