telemetry

package
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 9, 2026 License: MIT Imports: 1 Imported by: 0

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

func MetricsNames

func MetricsNames() []string

MetricsNames 返回本实现导出的 4 个指标名(供 OTel 对接/看板引用)。

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 NewCacheMetrics

func NewCacheMetrics() *CacheMetrics

NewCacheMetrics 创建指标聚合器。

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 记录一次请求的缓存指标。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL