指标收集 - 计量器属性

Code Source: https://github.com/gogf/examples/tree/main/observability/metric/meter_attributes

简介

本示例演示了如何在 GoFrame 中使用 OpenTelemetry 和 Prometheus 集成来配置和管理指标计量器级别的属性。主要展示：

• 配置计量器级别属性
• 在所有指标中应用属性
• 组合计量器和指标属性
• 管理属性继承关系

目录结构

.
├── go.mod            # Go模块文件
├── go.sum            # Go模块校验和
└── main.go           # 主程序，演示计量器属性使用

功能特性

本示例展示了以下功能：

1. 计量器属性

   • 全局计量器配置
   • 计量器级别属性
   • 属性继承机制

2. 带继承属性的指标类型

   • 带组合属性的计数器（Counter）
   • 带组合属性的可观察计数器（Observable Counter）
   • 属性优先级规则

3. 属性管理

   • 计量器属性配置
   • 基于版本的属性
   • 属性组合方式

环境要求

• Go 1.22 或更高版本
• GoFrame 框架
• GoFrame OpenTelemetry Metric 扩展

使用说明

1. 运行示例：

   go run main.go

2. 访问指标：

   # 使用curl
   curl http://localhost:8000/metrics
   
   # 或在浏览器中打开
   http://localhost:8000/metrics

3. 指标输出示例：

   # HELP goframe_metric_demo_counter 这是Counter用法的简单演示
   goframe_metric_demo_counter{const_attr_1="1",meter_label_1="1",meter_label_2="2"} 11
   
   # HELP goframe_metric_demo_observable_counter 这是ObservableCounter用法的简单演示
   goframe_metric_demo_observable_counter{const_attr_2="2",meter_label_1="1",meter_label_2="2"} 10

实现说明

1. 配置计量器属性

   // 创建全局计量器实例，配置计量器级别属性
   meter = gmetric.GetGlobalProvider().Meter(gmetric.MeterOption{
       Instrument:        instrument,        // 指标标识符
       InstrumentVersion: instrumentVersion, // 指标版本
       Attributes: gmetric.Attributes{       // 计量器级别属性
           gmetric.NewAttribute("meter_label_1", 1),
           gmetric.NewAttribute("meter_label_2", 2),
       },
   })

2. 创建带属性的指标

   // 创建Counter指标，包含计量器属性和指标特定属性
   counter = meter.MustCounter(
       "goframe.metric.demo.counter",
       gmetric.MetricOption{
           Help: "这是Counter用法的简单演示",
           Unit: "bytes",
           Attributes: gmetric.Attributes{
               gmetric.NewAttribute("const_attr_1", 1),
           },
       },
   )

3. 注册可观察指标回调

   // 注册回调函数，自动继承计量器属性
   meter.MustRegisterCallback(func(ctx context.Context, obs gmetric.Observer) error {
       obs.Observe(observableCounter, 10)
       return nil
   }, observableCounter)