指标属性用于在更上层的指标使用中进行过滤、汇总、统计等高纬度操作。在GoFrame框架的监控告警组件中，提供了3种属性注入方式：常量属性、变量属性和全局属性。

在OpenTelemetry中叫做指标属性（attributes），但在Prometheus中叫做指标标签（labels），两者是一个含义。

常量属性

常量属性是固定的一系列属性键值对，可以绑定到Meter中，也可以直接绑定到指标对象上。如果绑定到Meter上，那么Meter下所有创建的指标对象均带有该属性键值对，如果绑定到指标对象上，那么仅会在当前指标上生效。我们来看一个示例：

  1. package main
  3. import (
  4.     "context"
  6.     "go.opentelemetry.io/otel/exporters/prometheus"
  8.     "github.com/gogf/gf/contrib/metric/otelmetric/v2"
  9.     "github.com/gogf/gf/v2/frame/g"
  10.     "github.com/gogf/gf/v2/os/gctx"
  11.     "github.com/gogf/gf/v2/os/gmetric"
  12. )
  14. const (
  15.     instrument        = "github.com/gogf/gf/example/metric/basic"
  16.     instrumentVersion = "v1.0"
  17. )
  19. var (
  20.     meter = gmetric.GetGlobalProvider().Meter(gmetric.MeterOption{
  21.         Instrument:        instrument,
  22.         InstrumentVersion: instrumentVersion,
  23.         Attributes: gmetric.Attributes{
  24.             gmetric.NewAttribute("meter_const_attr_1", 1),
  25.         },
  26.     })
  27.     counter = meter.MustCounter(
  28.         "goframe.metric.demo.counter",
  29.         gmetric.MetricOption{
  30.             Help: "This is a simple demo for Counter usage",
  31.             Unit: "bytes",
  32.             Attributes: gmetric.Attributes{
  33.                 gmetric.NewAttribute("metric_const_attr_1", 1),
  34.             },
  35.         },
  36.     )
  37.     observableCounter = meter.MustObservableCounter(
  38.         "goframe.metric.demo.observable_counter",
  39.         gmetric.MetricOption{
  40.             Help: "This is a simple demo for ObservableCounter usage",
  41.             Unit: "%",
  42.             Attributes: gmetric.Attributes{
  43.                 gmetric.NewAttribute("metric_const_attr_2", 2),
  44.             },
  45.         },
  46.     )
  47. )
  49. func main() {
  50.     var ctx = gctx.New()
  51.     // Callback for observable metrics.
  52.     meter.MustRegisterCallback(func(ctx context.Context, obs gmetric.Observer) error {
  53.         obs.Observe(observableCounter, 10)
  54.         return nil
  55.     }, observableCounter)
  57.     // Prometheus exporter to export metrics as Prometheus format.
  58.     exporter, err := prometheus.New(
  59.         prometheus.WithoutCounterSuffixes(),
  60.         prometheus.WithoutUnits(),
  61.     )
  62.     if err != nil {
  63.         g.Log().Fatal(ctx, err)
  64.     }
  66.     // OpenTelemetry provider.
  67.     provider := otelmetric.MustProvider(
  68.         otelmetric.WithReader(exporter),
  69.     )
  70.     provider.SetAsGlobal()
  71.     defer provider.Shutdown(ctx)
  73.     // Counter.
  74.     counter.Inc(ctx)
  75.     counter.Add(ctx, 10)
  77.     // HTTP Server for metrics exporting.
  78.     otelmetric.StartPrometheusMetricsServer(8000, "/metrics")
  79. }

可以看到，我们通过创建Meter对象或者Metric对象时的MeterOption或MetricOption参数中的Attributes属性字段来指定常量属性。

执行后，我们访问 http://127.0.0.1:8000/metrics 看看结果。可以看到绑定到Meter上的常量属性在两个指标上生效了，但是在各个指标上绑定的常量属性仅在对应的指标上生效了。

监控告警-指标属性 - 图1

变量属性

变量属性是在指标运行时指定的属性键值对，通常只能在运行时才能确定属性的键值对信息，并且键值对可能根据不同的执行场景而发生变化，因此叫做变量属性。

我们来看一个示例：

  1. package main
  3. import (
  4.     "context"
  6.     "go.opentelemetry.io/otel/exporters/prometheus"
  8.     "github.com/gogf/gf/contrib/metric/otelmetric/v2"
  9.     "github.com/gogf/gf/v2/frame/g"
  10.     "github.com/gogf/gf/v2/os/gctx"
  11.     "github.com/gogf/gf/v2/os/gmetric"
  12. )
  14. const (
  15.     instrument        = "github.com/gogf/gf/example/metric/basic"
  16.     instrumentVersion = "v1.0"
  17. )
  19. var (
  20.     meter = gmetric.GetGlobalProvider().Meter(gmetric.MeterOption{
  21.         Instrument:        instrument,
  22.         InstrumentVersion: instrumentVersion,
  23.         Attributes: gmetric.Attributes{
  24.             gmetric.NewAttribute("meter_const_attr_1", 1),
  25.         },
  26.     })
  27.     counter = meter.MustCounter(
  28.         "goframe.metric.demo.counter",
  29.         gmetric.MetricOption{
  30.             Help: "This is a simple demo for Counter usage",
  31.             Unit: "bytes",
  32.             Attributes: gmetric.Attributes{
  33.                 gmetric.NewAttribute("metric_const_attr_1", 1),
  34.             },
  35.         },
  36.     )
  37.     observableCounter = meter.MustObservableCounter(
  38.         "goframe.metric.demo.observable_counter",
  39.         gmetric.MetricOption{
  40.             Help: "This is a simple demo for ObservableCounter usage",
  41.             Unit: "%",
  42.             Attributes: gmetric.Attributes{
  43.                 gmetric.NewAttribute("metric_const_attr_2", 2),
  44.             },
  45.         },
  46.     )
  47. )
  49. func main() {
  50.     var ctx = gctx.New()
  51.     // Callback for observable metrics.
  52.     meter.MustRegisterCallback(func(ctx context.Context, obs gmetric.Observer) error {
  53.         obs.Observe(observableCounter, 10, gmetric.Option{
  54.             Attributes: gmetric.Attributes{
  55.                 gmetric.NewAttribute("dynamic_attr_1", 1),
  56.             },
  57.         })
  58.         return nil
  59.     }, observableCounter)
  61.     // Prometheus exporter to export metrics as Prometheus format.
  62.     exporter, err := prometheus.New(
  63.         prometheus.WithoutCounterSuffixes(),
  64.         prometheus.WithoutUnits(),
  65.     )
  66.     if err != nil {
  67.         g.Log().Fatal(ctx, err)
  68.     }
  70.     // OpenTelemetry provider.
  71.     provider := otelmetric.MustProvider(
  72.         otelmetric.WithReader(exporter),
  73.     )
  74.     provider.SetAsGlobal()
  75.     defer provider.Shutdown(ctx)
  77.     // Counter.
  78.     counter.Inc(ctx, gmetric.Option{
  79.         Attributes: gmetric.Attributes{
  80.             gmetric.NewAttribute("dynamic_attr_2", 2),
  81.         },
  82.     })
  83.     counter.Add(ctx, 10, gmetric.Option{
  84.         Attributes: gmetric.Attributes{
  85.             gmetric.NewAttribute("dynamic_attr_3", 3),
  86.         },
  87.     })
  89.     // HTTP Server for metrics exporting.
  90.     otelmetric.StartPrometheusMetricsServer(8000, "/metrics")
  91. }

可以看到，我们在运行通过Option参数中的Attributes属性字段来指定指标变量属性，变量属性比较灵活，相同的指标也可以使用不同的变量属性。

同样的，执行后，我们访问 http://127.0.0.1:8000/metrics 看看结果。

监控告警-指标属性 - 图2

全局属性

全局属性是一种更加灵活的指标属性注入方式，可以根据Instrument信息进行属性自动注入，并且可以根据Instrument名称的正则匹配来判断是否往该Instrument下所有的指标注入指标属性信息。

我们来看一个示例：

  1. package main
  3. import (
  4.     "context"
  6.     "go.opentelemetry.io/otel/exporters/prometheus"
  8.     "github.com/gogf/gf/contrib/metric/otelmetric/v2"
  9.     "github.com/gogf/gf/v2/frame/g"
  10.     "github.com/gogf/gf/v2/os/gctx"
  11.     "github.com/gogf/gf/v2/os/gmetric"
  12. )
  14. const (
  15.     instrument        = "github.com/gogf/gf/example/metric/basic"
  16.     instrumentVersion = "v1.0"
  17. )
  19. var (
  20.     meter = gmetric.GetGlobalProvider().Meter(gmetric.MeterOption{
  21.         Instrument:        instrument,
  22.         InstrumentVersion: instrumentVersion,
  23.         Attributes: gmetric.Attributes{
  24.             gmetric.NewAttribute("meter_const_attr_1", 1),
  25.         },
  26.     })
  27.     counter = meter.MustCounter(
  28.         "goframe.metric.demo.counter",
  29.         gmetric.MetricOption{
  30.             Help: "This is a simple demo for Counter usage",
  31.             Unit: "bytes",
  32.             Attributes: gmetric.Attributes{
  33.                 gmetric.NewAttribute("metric_const_attr_1", 1),
  34.             },
  35.         },
  36.     )
  37.     observableCounter = meter.MustObservableCounter(
  38.         "goframe.metric.demo.observable_counter",
  39.         gmetric.MetricOption{
  40.             Help: "This is a simple demo for ObservableCounter usage",
  41.             Unit: "%",
  42.             Attributes: gmetric.Attributes{
  43.                 gmetric.NewAttribute("metric_const_attr_2", 2),
  44.             },
  45.         },
  46.     )
  47. )
  49. func main() {
  50.     var ctx = gctx.New()
  52.     gmetric.SetGlobalAttributes(gmetric.Attributes{
  53.         gmetric.NewAttribute("global_attr_1", 1),
  54.     }, gmetric.SetGlobalAttributesOption{
  55.         Instrument:        instrument,
  56.         InstrumentVersion: instrumentVersion,
  57.         InstrumentPattern: "",
  58.     })
  60.     // Callback for observable metrics.
  61.     meter.MustRegisterCallback(func(ctx context.Context, obs gmetric.Observer) error {
  62.         obs.Observe(observableCounter, 10, gmetric.Option{
  63.             Attributes: gmetric.Attributes{
  64.                 gmetric.NewAttribute("dynamic_attr_1", 1),
  65.             },
  66.         })
  67.         return nil
  68.     }, observableCounter)
  70.     // Prometheus exporter to export metrics as Prometheus format.
  71.     exporter, err := prometheus.New(
  72.         prometheus.WithoutCounterSuffixes(),
  73.         prometheus.WithoutUnits(),
  74.     )
  75.     if err != nil {
  76.         g.Log().Fatal(ctx, err)
  77.     }
  79.     // OpenTelemetry provider.
  80.     provider := otelmetric.MustProvider(
  81.         otelmetric.WithReader(exporter),
  82.     )
  83.     provider.SetAsGlobal()
  84.     defer provider.Shutdown(ctx)
  86.     // Counter.
  87.     counter.Inc(ctx, gmetric.Option{
  88.         Attributes: gmetric.Attributes{
  89.             gmetric.NewAttribute("dynamic_attr_2", 2),
  90.         },
  91.     })
  92.     counter.Add(ctx, 10, gmetric.Option{
  93.         Attributes: gmetric.Attributes{
  94.             gmetric.NewAttribute("dynamic_attr_3", 3),
  95.         },
  96.     })
  98.     // HTTP Server for metrics exporting.
  99.     otelmetric.StartPrometheusMetricsServer(8000, "/metrics")
  100. }

通过gmetric.SetGlobalAttributes方法设置全局属性，并且根据参数gmetric.SetGlobalAttributesOption限制影响的指标范围。

同样的，执行后，我们访问 http://127.0.0.1:8000/metrics 看看结果。可以看到，全局属性已经自动添加到了指标中。

监控告警-指标属性 - 图3