Documentation
¶
Overview ¶
Package telemetry 提供缓存命中率监控指标与告警协同。
对应任务 N09:Grafana 缓存命中率看板 + OTel 探针。
本实现提供 4 个"OTel 语义"的指标(HashAgg / Counter / Histogram 的轻量占位, 便于无 collector 环境测试;接入真实 OTel SDK 时替换为对应 Instrument 即可):
- omnix.cache.hit_ratio (Histogram, 按 session/preset/turn 维度)
- omnix.cache.hit_tokens (Counter)
- omnix.cache.miss_tokens (Counter)
- omnix.cache.broken_count (Counter,检测到可缓存破窗模式 +1)
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type CacheMetrics ¶
type CacheMetrics struct {
HitRatios []float64 // 命中率历史(Histogram 样本)
HitTokensTotal int64
MissTokensTotal int64
BrokenCount int64
// Session 维度标签(当前局)。
SessionID string
Preset string
TurnSeq int
// contains filtered or unexported fields
}
CacheMetrics 是缓存命中率指标聚合器。
func (*CacheMetrics) HistogramP50 ¶
func (m *CacheMetrics) HistogramP50() float64
HistogramP50 计算命中率样本的 P50(分位数),用于 Grafana 告警规则 hit_ratio_p50。
func (*CacheMetrics) MarkBroken ¶
func (m *CacheMetrics) MarkBroken()
MarkBroken 标记一次破窗事件(broken_count +1)。
func (*CacheMetrics) Record ¶
func (m *CacheMetrics) Record(hit, miss int, ratio float64)
Record 记录一次请求的缓存指标。
Click to show internal directories.
Click to hide internal directories.