ActiveGo 1.8Package dogstatsd
Overview ▹
Index ▹
type Counter ¶
Counter is a DogStatsD counter. Observations are forwarded to a Dogstatsd object, and aggregated (summed) per timeseries.
type Counter struct {
// contains filtered or unexported fields
}
func (*Counter) Add ¶
func (c *Counter) Add(delta float64)
Add implements metrics.Counter.
func (*Counter) With ¶
func (c *Counter) With(labelValues ...string) metrics.Counter
With implements metrics.Counter.
type Dogstatsd ¶
Dogstatsd receives metrics observations and forwards them to a DogStatsD server. Create a Dogstatsd object, use it to create metrics, and pass those metrics as dependencies to the components that will use them.
All metrics are buffered until WriteTo is called. Counters and gauges are aggregated into a single observation per timeseries per write. Timings and histograms are buffered but not aggregated.
To regularly report metrics to an io.Writer, use the WriteLoop helper method. To send to a DogStatsD server, use the SendLoop helper method.
type Dogstatsd struct {
// contains filtered or unexported fields
}
func New ¶
func New(prefix string, logger log.Logger) *Dogstatsd
New returns a Dogstatsd object that may be used to create metrics. Prefix is applied to all created metrics. Callers must ensure that regular calls to WriteTo are performed, either manually or with one of the helper methods.
func (*Dogstatsd) NewCounter ¶
func (d *Dogstatsd) NewCounter(name string, sampleRate float64) *Counter
NewCounter returns a counter, sending observations to this Dogstatsd object.
func (*Dogstatsd) NewGauge ¶
func (d *Dogstatsd) NewGauge(name string) *Gauge
NewGauge returns a gauge, sending observations to this Dogstatsd object.
func (*Dogstatsd) NewHistogram ¶
func (d *Dogstatsd) NewHistogram(name string, sampleRate float64) *Histogram
NewHistogram returns a histogram whose observations are of an unspecified unit, and are forwarded to this Dogstatsd object.
func (*Dogstatsd) NewTiming ¶
func (d *Dogstatsd) NewTiming(name string, sampleRate float64) *Timing
NewTiming returns a histogram whose observations are interpreted as millisecond durations, and are forwarded to this Dogstatsd object.
func (*Dogstatsd) SendLoop ¶
func (d *Dogstatsd) SendLoop(c <-chan time.Time, network, address string)
SendLoop is a helper method that wraps WriteLoop, passing a managed connection to the network and address. Like WriteLoop, this method blocks until the channel is closed, so clients probably want to start it in its own goroutine. For typical usage, create a time.Ticker and pass its C channel to this method.
func (*Dogstatsd) WriteLoop ¶
func (d *Dogstatsd) WriteLoop(c <-chan time.Time, w io.Writer)
WriteLoop is a helper method that invokes WriteTo to the passed writer every time the passed channel fires. This method blocks until the channel is closed, so clients probably want to run it in its own goroutine. For typical usage, create a time.Ticker and pass its C channel to this method.
func (*Dogstatsd) WriteTo ¶
func (d *Dogstatsd) WriteTo(w io.Writer) (count int64, err error)
WriteTo flushes the buffered content of the metrics to the writer, in DogStatsD format. WriteTo abides best-effort semantics, so observations are lost if there is a problem with the write. Clients should be sure to call WriteTo regularly, ideally through the WriteLoop or SendLoop helper methods.
type Gauge ¶
Gauge is a DogStatsD gauge. Observations are forwarded to a Dogstatsd object, and aggregated (the last observation selected) per timeseries.
type Gauge struct {
// contains filtered or unexported fields
}
func (*Gauge) Add ¶
func (g *Gauge) Add(delta float64)
Add implements metrics.Gauge.
func (*Gauge) Set ¶
func (g *Gauge) Set(value float64)
Set implements metrics.Gauge.
func (*Gauge) With ¶
func (g *Gauge) With(labelValues ...string) metrics.Gauge
With implements metrics.Gauge.
type Histogram ¶
Histogram is a DogStatsD histrogram. Observations are forwarded to a Dogstatsd object, and collected (but not aggregated) per timeseries.
type Histogram struct {
// contains filtered or unexported fields
}
func (*Histogram) Observe ¶
func (h *Histogram) Observe(value float64)
Observe implements metrics.Histogram.
func (*Histogram) With ¶
func (h *Histogram) With(labelValues ...string) metrics.Histogram
With implements metrics.Histogram.
type Timing ¶
Timing is a DogStatsD timing, or metrics.Histogram. Observations are forwarded to a Dogstatsd object, and collected (but not aggregated) per timeseries.
type Timing struct {
// contains filtered or unexported fields
}
func (*Timing) Observe ¶
func (t *Timing) Observe(value float64)
Observe implements metrics.Histogram. Value is interpreted as milliseconds.
func (*Timing) With ¶
func (t *Timing) With(labelValues ...string) metrics.Histogram
With implements metrics.Timing.