metrics

type Counter interface {
	// Inc 增加1
	Inc()
	// Add 增加给定值
	Add(float64)
}

type CounterOptions struct {
	Name   string            // 指标名称
	Help   string            // 指标帮助信息
	Labels map[string]string // 指标标签
}

type CounterVec interface {
	// With 使用标签获取Counter
	With(map[string]string) Counter
}

type Gauge interface {
	// Set 设置值
	Set(float64)
	// Inc 增加1
	Inc()
	// Dec 减少1
	Dec()
	// Add 增加给定值
	Add(float64)
	// Sub 减少给定值
	Sub(float64)
	// SetToCurrentTime 设置为当前时间戳
	SetToCurrentTime()
}

type GaugeOptions struct {
	Name   string            // 指标名称
	Help   string            // 指标帮助信息
	Labels map[string]string // 指标标签
}

type GaugeVec interface {
	// With 使用标签获取Gauge
	With(map[string]string) Gauge
}

type Histogram interface {
	// Observe 观察值
	Observe(float64)
}

type HistogramOptions struct {
	Name    string            // 指标名称
	Help    string            // 指标帮助信息
	Labels  map[string]string // 指标标签
	Buckets []float64         // 桶数组
}

type HistogramVec interface {
	// With 使用标签获取Histogram
	With(map[string]string) Histogram
}

type Metrics interface {
	// Counter 计数器
	Counter(name string, value float64, labels map[string]string)
	// Gauge 仪表
	Gauge(name string, value float64, labels map[string]string)
	// Histogram 直方图
	Histogram(name string, value float64, labels map[string]string)

	// CreateCounter 创建计数器
	CreateCounter(opts CounterOptions) Counter
	// CreateCounterVec 创建带标签的计数器
	CreateCounterVec(opts CounterOptions, labelNames []string) CounterVec
	// CreateGauge 创建仪表盘
	CreateGauge(opts GaugeOptions) Gauge
	// CreateGaugeVec 创建带标签的仪表盘
	CreateGaugeVec(opts GaugeOptions, labelNames []string) GaugeVec
	// CreateHistogram 创建直方图
	CreateHistogram(opts HistogramOptions) Histogram
	// CreateHistogramVec 创建带标签的直方图
	CreateHistogramVec(opts HistogramOptions, labelNames []string) HistogramVec
	// CreateSummary 创建摘要
	CreateSummary(opts SummaryOptions) Summary
	// CreateSummaryVec 创建带标签的摘要
	CreateSummaryVec(opts SummaryOptions, labelNames []string) SummaryVec
}

type Option func(*options)

type Summary interface {
	// Observe 观察值
	Observe(float64)
}

type SummaryOptions struct {
	Name       string              // 指标名称
	Help       string              // 指标帮助信息
	Labels     map[string]string   // 指标标签
	Objectives map[float64]float64 // 分位数
	MaxAge     time.Duration       // 最大存活时间
	AgeBuckets uint32              // 年龄桶数量
	BufCap     uint32              // 缓冲区容量
}

type SummaryVec interface {
	// With 使用标签获取Summary
	With(map[string]string) Summary
}