Package pcp
Overview ▹
Index ▹
type Counter ¶
Counter implements metrics.Counter via a single dimensional speed.Counter.
type Counter struct {
// contains filtered or unexported fields
}
func (*Counter) Add ¶
func (c *Counter) Add(delta float64)
Add increments Counter. speed.Counters only take int64, so delta is converted to int64 before observation.
func (*Counter) With ¶
func (c *Counter) With(labelValues ...string) metrics.Counter
With is a no-op.
type Gauge ¶
Gauge implements metrics.Gauge via a single dimensional speed.Gauge.
type Gauge struct {
// contains filtered or unexported fields
}
func (*Gauge) Add ¶
func (g *Gauge) Add(delta float64)
Add adds a value to the gauge.
func (*Gauge) Set ¶
func (g *Gauge) Set(value float64)
Set sets the value of the gauge.
func (*Gauge) With ¶
func (g *Gauge) With(labelValues ...string) metrics.Gauge
With is a no-op.
type Histogram ¶
Histogram wraps a speed Histogram.
type Histogram struct {
// contains filtered or unexported fields
}
func (*Histogram) Mean ¶
func (h *Histogram) Mean() float64
Mean returns the mean of the values observed so far by the Histogram.
func (*Histogram) Observe ¶
func (h *Histogram) Observe(value float64)
Observe observes a value.
This converts float64 value to int64 before observation, as the Histogram in speed is backed using codahale/hdrhistogram, which only observes int64 values. Additionally, the value is interpreted in the metric unit used to construct the histogram.
func (*Histogram) Percentile ¶
func (h *Histogram) Percentile(p float64) int64
Percentile returns a percentile value for the given percentile between 0 and 100 for all values observed by the histogram.
func (*Histogram) With ¶
func (h *Histogram) With(labelValues ...string) metrics.Histogram
With is a no-op.
type Reporter ¶
Reporter encapsulates a speed client.
type Reporter struct {
// contains filtered or unexported fields
}
func NewReporter ¶
func NewReporter(appname string) (*Reporter, error)
NewReporter creates a new Reporter instance. The first parameter is the application name and is used to create the speed client. Hence it should be a valid speed parameter name and should not contain spaces or the path separator for your operating system.
func (*Reporter) NewCounter ¶
func (r *Reporter) NewCounter(name string, desc ...string) (*Counter, error)
NewCounter creates a new Counter. This requires a name parameter and can optionally take a couple of description strings, that are used to create the underlying speed.Counter and are reported by PCP.
func (*Reporter) NewGauge ¶
func (r *Reporter) NewGauge(name string, desc ...string) (*Gauge, error)
NewGauge creates a new Gauge. This requires a name parameter and can optionally take a couple of description strings, that are used to create the underlying speed.Gauge and are reported by PCP.
func (*Reporter) NewHistogram ¶
func (r *Reporter) NewHistogram(name string, min, max int64, unit speed.MetricUnit, desc ...string) (*Histogram, error)
NewHistogram creates a new Histogram. The minimum observeable value is 0. The maximum observeable value is 3600000000 (3.6e9).
The required parameters are a metric name, the minimum and maximum observable values, and a metric unit for the units of the observed values.
Optionally, it can also take a couple of description strings.
func (*Reporter) Start ¶
func (r *Reporter) Start()
Start starts the underlying speed client so it can start reporting registered metrics to your PCP installation.
func (*Reporter) Stop ¶
func (r *Reporter) Stop()
Stop stops the underlying speed client so it can stop reporting registered metrics to your PCP installation.