指标

在 OpenTelemetry 中，指标 是服务运行时捕获的数值。某一时刻的数值也叫指标事件（metric event），包含数值本身、时间和一些元信息。

指标仪器

指标仪器（metric instrument） 是代码中某一指标的捕获器，一个 指标仪器 包含 ^[1]：

• 指标名
• 类型
• 单位（可选）
• 描述（可选）

指标类型

OpenTelemetry 定义了六种指标类型 ^[1:1]：

同步仪器 需要在操作进行时主动调用：

• Counter
• UpDownCounter
• Histogram

异步仪器 需要提供回调函数，在特定条件下被调用，因此也无法和操作上下文关联：

• Asynchronous Counter
• Asynchronous UpDownCounter
• Asynchronous Gauge

他们的对比汇总：

对于 Counter、Asynchronous Counter 和 Histogram 类型，强烈建议使用 delta 指标而不是 cumulative^[2]，这样传输的数据更小，并且对于 ClickHouse 等非 prometheus 的后端存储而言，delta 类型可以有更多计算方式。

• 方法一：环境变量

   export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=DELTA
  

• 方法二：SDK 代码调用

   import (
       "go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp"
       sdkmetric "go.opentelemetry.io/otel/sdk/metric"
   )
   
   exporter, err := otlpmetrichttp.New(ctx,
    	otlpmetrichttp.WithEndpoint(...),
    	...
    	otlpmetrichttp.WithTemporalitySelector(func (kind sdkmetric.InstrumentKind) metricdata.Temporality {
        	switch kind {
        	case sdkmetric.InstrumentKindCounter,
        		sdkmetric.InstrumentKindObservableCounter,
        		sdkmetric.InstrumentKindHistogram:
        		return metricdata.DeltaTemporality
        	default:
        		return metricdata.CumulativeTemporality
        	}
        }),
    )
  

选择仪器

参考 uptrace^[3]：

1. 需要直方图、热力图或者百分位数：Histogram
2. 需要统计增量值
   • 如果是单调的：Counter
   • 否则：UpDownCounter
3. 需要统计实际值
   • 数值可累加
     • 如果是单调的：Asynchronous Counter
     • 否则：Asynchronous UpDownCounter
   • 否则：Gauge

聚合

在 OTLP 协议中，指标会被聚合后传输，专门用于展示系统的统计信息。共有三种聚合类型 ^[4]：

• Sum Aggregation：将窗口内测量值汇总
• Last Value Aggregation：只记录窗口内最后一个测量值
• Explicit Bucket Histogram Aggregation：记录测量值分布到不同桶（预先在视图中配置）的数量，以及最大、最小值等统计信息

视图

视图 是 SDK 中重要能力，用于调整哪些仪器被处理、被忽略，以及调整 聚合 方式。

每个指标类型都有默认聚合类型：