52 lines
1.6 KiB
Go
52 lines
1.6 KiB
Go
|
package telemetry
|
||
|
|
|
||
|
|
import "net/http"
|
||
|
|
|
||
|
|
// Meter 是 telemetry 的高层入口。所有业务埋点都通过它创建指标;
|
||
|
|
// 测试时可替换为 NoopMeter 或带缓冲的自定义实现。
|
||
|
|
type Meter struct {
|
||
|
|
reg *Registry
|
||
|
|
}
|
||
|
|
|
||
|
|
// NewMeter 创建默认实现。
|
||
|
|
func NewMeter() *Meter {
|
||
|
|
return &Meter{reg: newRegistry()}
|
||
|
|
}
|
||
|
|
|
||
|
|
// Handler 返回 /metrics 端点的 http.Handler。
|
||
|
|
func (m *Meter) Handler() http.Handler { return m.reg.Handler() }
|
||
|
|
|
||
|
|
// Registry 暴露给特殊用例(如测试断言),生产代码不应使用。
|
||
|
|
func (m *Meter) Registry() *Registry { return m.reg }
|
||
|
|
|
||
|
|
// NewCounter 注册并返回一个 Counter。
|
||
|
|
// - name 指标名(Prometheus 风格,如 "tts_request_total")
|
||
|
|
// - help 帮助文本
|
||
|
|
// - labelNames 注册时锁定的 label key 集合,运行期不可变
|
||
|
|
func (m *Meter) NewCounter(name, help string, labelNames ...string) *Counter {
|
||
|
|
c := newCounter(name, help, labelNames)
|
||
|
|
if err := m.reg.register(name, c); err != nil {
|
||
|
|
// 注册重名是启动期 bug,直接 panic 让问题在启动时暴露。
|
||
|
|
panic(err)
|
||
|
|
}
|
||
|
|
return c
|
||
|
|
}
|
||
|
|
|
||
|
|
// NewGauge 同 NewCounter。
|
||
|
|
func (m *Meter) NewGauge(name, help string, labelNames ...string) *Gauge {
|
||
|
|
g := newGauge(name, help, labelNames)
|
||
|
|
if err := m.reg.register(name, g); err != nil {
|
||
|
|
panic(err)
|
||
|
|
}
|
||
|
|
return g
|
||
|
|
}
|
||
|
|
|
||
|
|
// NewHistogram 同 NewCounter,额外接受桶上界(不含 +Inf,+Inf 由实现自动追加)。
|
||
|
|
func (m *Meter) NewHistogram(name, help string, buckets []float64, labelNames ...string) *Histogram {
|
||
|
|
h := newHistogram(name, help, buckets, labelNames)
|
||
|
|
if err := m.reg.register(name, h); err != nil {
|
||
|
|
panic(err)
|
||
|
|
}
|
||
|
|
return h
|
||
|
|
}
|