mirror of
https://github.com/golang/go
synced 2024-11-06 06:36:20 -07:00
d9ab56aa29
This changes to use a mutex and directly execute the less performance sensitive telemetry calls (tracing and logging) and then uses a submission queue only for stats adjustments as those are much more sensitive (but it should also be easier to keep up with them in bursts) Fixes golang/go#33692 Change-Id: Ia59a8975f21dfbfcf115be1f1d11b097be8dd9c8 Reviewed-on: https://go-review.googlesource.com/c/tools/+/190737 Run-TryBot: Ian Cottrell <iancottrell@google.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Rebecca Stambler <rstambler@golang.org> Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com>
99 lines
3.1 KiB
Go
99 lines
3.1 KiB
Go
// Copyright 2019 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// Package stats provides support for recording telemetry statistics.
|
|
// It acts as a coordination point between things that want to record stats,
|
|
// and things that want to aggregate and report stats.
|
|
package stats
|
|
|
|
import (
|
|
"context"
|
|
|
|
"golang.org/x/tools/internal/telemetry/unit"
|
|
)
|
|
|
|
// Int64Measure is used to record integer values.
|
|
type Int64Measure struct {
|
|
name string
|
|
description string
|
|
unit unit.Unit
|
|
subscribers []Int64Subscriber
|
|
}
|
|
|
|
// Int64Measure is used to record floating point values.
|
|
type Float64Measure struct {
|
|
name string
|
|
description string
|
|
unit unit.Unit
|
|
subscribers []Float64Subscriber
|
|
}
|
|
|
|
// Int64Subscriber is the type for functions that want to listen to
|
|
// integer statistic events.
|
|
type Int64Subscriber func(context.Context, *Int64Measure, int64)
|
|
|
|
// Float64Subscriber is the type for functions that want to listen to
|
|
// floating point statistic events.
|
|
type Float64Subscriber func(context.Context, *Float64Measure, float64)
|
|
|
|
// Int64 creates a new Int64Measure and prepares it for use.
|
|
func Int64(name string, description string, unit unit.Unit) *Int64Measure {
|
|
return &Int64Measure{
|
|
name: name,
|
|
description: description,
|
|
unit: unit,
|
|
}
|
|
}
|
|
|
|
// Float64 creates a new Float64Measure and prepares it for use.
|
|
func Float64(name string, description string, unit unit.Unit) *Float64Measure {
|
|
return &Float64Measure{
|
|
name: name,
|
|
description: description,
|
|
unit: unit,
|
|
}
|
|
}
|
|
|
|
// Name returns the name this measure was given on construction.
|
|
func (m *Int64Measure) Name() string { return m.name }
|
|
|
|
// Description returns the description this measure was given on construction.
|
|
func (m *Int64Measure) Description() string { return m.description }
|
|
|
|
// Unit returns the units this measure was given on construction.
|
|
func (m *Int64Measure) Unit() unit.Unit { return m.unit }
|
|
|
|
// Subscribe adds a new subscriber to this measure.
|
|
func (m *Int64Measure) Subscribe(s Int64Subscriber) { m.subscribers = append(m.subscribers, s) }
|
|
|
|
// Record delivers a new value to the subscribers of this measure.
|
|
func (m *Int64Measure) Record(ctx context.Context, value int64) {
|
|
do(func() {
|
|
for _, s := range m.subscribers {
|
|
s(ctx, m, value)
|
|
}
|
|
})
|
|
}
|
|
|
|
// Name returns the name this measure was given on construction.
|
|
func (m *Float64Measure) Name() string { return m.name }
|
|
|
|
// Description returns the description this measure was given on construction.
|
|
func (m *Float64Measure) Description() string { return m.description }
|
|
|
|
// Unit returns the units this measure was given on construction.
|
|
func (m *Float64Measure) Unit() unit.Unit { return m.unit }
|
|
|
|
// Subscribe adds a new subscriber to this measure.
|
|
func (m *Float64Measure) Subscribe(s Float64Subscriber) { m.subscribers = append(m.subscribers, s) }
|
|
|
|
// Record delivers a new value to the subscribers of this measure.
|
|
func (m *Float64Measure) Record(ctx context.Context, value float64) {
|
|
do(func() {
|
|
for _, s := range m.subscribers {
|
|
s(ctx, m, value)
|
|
}
|
|
})
|
|
}
|