metrics 包的全局指标(UpstreamTotal 等)默认是 nil,只有 main 调过 metrics.Init() 之后才有值。任何不经过 main 的调用路径都会在 controller/tts.go -> adapter/volcano/synthesis.go -> metrics.AdapterRecorder 处 nil 解引用,整个进程崩掉。 生产路径本来没问题(二进制一定先 Init),但这类崩溃只在运行时暴露,且漏掉指标初始化属于很容易踩的装配错误,不该以 panic 收场。 改动: Counter.Add / Gauge.Set / Gauge.Add / Histogram.Observe 增加空接收者判断,nil 时静默忽略(与 noop 语义一致);在包注释里写成显式设计约定,避免以后被当成冗余代码删掉。
105 lines
2.0 KiB
Go
105 lines
2.0 KiB
Go
package telemetry
|
|
|
|
import (
|
|
"fmt"
|
|
"io"
|
|
"sort"
|
|
"sync"
|
|
"sync/atomic"
|
|
)
|
|
|
|
// Gauge 可增可减的瞬时值。
|
|
type Gauge struct {
|
|
metricName string
|
|
help string
|
|
labelNames []string
|
|
|
|
mu sync.RWMutex
|
|
values map[string]*gaugeChild
|
|
}
|
|
|
|
type gaugeChild struct {
|
|
labels Labels
|
|
bits atomic.Uint64
|
|
}
|
|
|
|
func newGauge(name, help string, labelNames []string) *Gauge {
|
|
return &Gauge{
|
|
metricName: name,
|
|
help: help,
|
|
labelNames: append([]string(nil), labelNames...),
|
|
values: make(map[string]*gaugeChild),
|
|
}
|
|
}
|
|
|
|
// Set 直接设置当前值。
|
|
// 空接收者(nil *Gauge)安全,见 Counter.Add 的说明。
|
|
func (g *Gauge) Set(v float64, labels Labels) {
|
|
if g == nil {
|
|
return
|
|
}
|
|
child := g.getOrCreate(labels)
|
|
child.bits.Store(float64bits(v))
|
|
}
|
|
|
|
// Inc +1。
|
|
func (g *Gauge) Inc(labels Labels) { g.Add(1, labels) }
|
|
|
|
// Dec -1。
|
|
func (g *Gauge) Dec(labels Labels) { g.Add(-1, labels) }
|
|
|
|
// Add 累加 v(可负)。
|
|
// 空接收者(nil *Gauge)安全,见 Counter.Add 的说明。
|
|
func (g *Gauge) Add(v float64, labels Labels) {
|
|
if g == nil {
|
|
return
|
|
}
|
|
child := g.getOrCreate(labels)
|
|
for {
|
|
bits := child.bits.Load()
|
|
cur := float64frombits(bits)
|
|
next := float64bits(cur + v)
|
|
if child.bits.CompareAndSwap(bits, next) {
|
|
return
|
|
}
|
|
}
|
|
}
|
|
|
|
func (g *Gauge) getOrCreate(labels Labels) *gaugeChild {
|
|
key := labelKey(g.labelNames, labels)
|
|
g.mu.RLock()
|
|
if c, ok := g.values[key]; ok {
|
|
g.mu.RUnlock()
|
|
return c
|
|
}
|
|
g.mu.RUnlock()
|
|
|
|
g.mu.Lock()
|
|
defer g.mu.Unlock()
|
|
if c, ok := g.values[key]; ok {
|
|
return c
|
|
}
|
|
c := &gaugeChild{labels: copyLabels(labels, g.labelNames)}
|
|
g.values[key] = c
|
|
return c
|
|
}
|
|
|
|
func (g *Gauge) collect(w io.Writer) {
|
|
fmt.Fprintf(w, "# HELP %s %s\n", g.metricName, g.help)
|
|
fmt.Fprintf(w, "# TYPE %s gauge\n", g.metricName)
|
|
|
|
g.mu.RLock()
|
|
keys := make([]string, 0, len(g.values))
|
|
for k := range g.values {
|
|
keys = append(keys, k)
|
|
}
|
|
sort.Strings(keys)
|
|
defer g.mu.RUnlock()
|
|
|
|
for _, k := range keys {
|
|
child := g.values[k]
|
|
val := float64frombits(child.bits.Load())
|
|
writeMetricLine(w, g.metricName, child.labels, val)
|
|
}
|
|
}
|