OpenTelemetry指标未导出至控制台问题排查求助

我正在编写OpenTelemetry指标导出的概念验证原型代码，目的是熟悉OpenTelemetry库的指标导出功能。目前能看到MeterProvider的初始化信息输出到控制台，但累积的指标数据却无法显示。

参考了官方.NET示例，以下是我的初始化代码：

public static MeterProvider GetMeterProvider(string service, string version, string meterName, bool consoleExporter, bool OtlpExporter)
{
    MeterProviderBuilder mpb = Sdk.CreateMeterProviderBuilder()
        .ConfigureResource(r => r.AddService(service, null, version))
        .AddMeter(meterName); // 启用此Meter下的所有工具

    if (consoleExporter)
    {
        mpb.AddConsoleExporter((exporterOptions, metricReaderOptions) =>
        {
            exporterOptions.Targets = ConsoleExporterOutputTargets.Console;

            metricReaderOptions.PeriodicExportingMetricReaderOptions.ExportIntervalMilliseconds = 1000;
            metricReaderOptions.TemporalityPreference = MetricReaderTemporalityPreference.Delta;
        });
    }

    if (OtlpExporter)
    {
       <...省略...>
    }

    return mpb.Build();
}

函数调用如下，返回的MeterProvider被赋值给类成员变量以持久化：

m_meterProvider = TelemetryUtils.GetMeterProvider(c_Service, c_Version, "Prototype", true, false);

创建MeterProvider后，我创建了以下Meter及指标工具：

m_meter = new Meter("Telemetry", "8.1");
m_counter = m_meter.CreateCounter<int>("counter", "things", "A count of things");
m_histogram = m_meter.CreateHistogram<int>("histogram");

我怀疑问题在于Meter未与MeterProvider关联。示例代码中有using var provider = providerBuilder.Build();语句，但不确定其作用。我的代码中MeterProvider已持久化到类成员变量中。

以下是循环内的指标收集代码，我甚至添加了ForceFlush，但仍无指标输出到控制台，请问我遗漏了什么步骤？

var observableCounter = m_meter.CreateObservableGauge("gauge", () =>
{
    return new List<Measurement<int>>()
        {
        new Measurement<int>(
            9999999,
            new KeyValuePair<string, object>("tag1", "value1")),
        };
});

m_histogram?.Record(Counter);

m_histogram?.Record(
    Counter * 100,
    new KeyValuePair<string, object>("tag1", "value1"));

m_counter?.Add(Counter);

m_counter?.Add(
    Counter * 100,
    new KeyValuePair<string, object>("tag2", "value2"));

m_meterProvider.ForceFlush();

问题根源与解决方案 #

1. Meter名称不匹配 #

你创建Meter时用的是"Telemetry"，但在MeterProvider初始化时调用AddMeter(meterName)传入的是"Prototype"——Meter名称必须和AddMeter中指定的名称完全匹配，否则MeterProvider不会采集这个Meter的指标。

修改方式二选一：

• 把创建Meter的代码改成new Meter("Prototype", "8.1");
• 在调用GetMeterProvider时，把第三个参数改成"Telemetry"

2. ObservableGauge的生命周期问题 #

你在循环内创建observableCounter，每次循环都会生成新的ObservableGauge实例，这会导致资源泄漏，还可能干扰指标采集逻辑。应该把ObservableGauge的创建移到循环外，作为类成员变量持久化。

3. 关于using var provider的作用 #

using var是为了确保MeterProvider在作用域结束时被正确释放，但你的代码中已经把MeterProvider存为类成员变量，只要这个变量不被GC回收，就不会有问题——这部分你的处理是对的，不是问题根源。

4. 额外检查点 #

• 确认Counter变量有有效值（不是0或未初始化），如果Counter为0，Add/Record操作不会产生可观测的指标变化
• 确保MeterProvider实例在整个程序生命周期内保持存活，不要被提前回收

修正后的关键代码示例 #

修正Meter名称匹配

// 方式一：调用GetMeterProvider时传入Meter的实际名称
m_meterProvider = TelemetryUtils.GetMeterProvider(c_Service, c_Version, "Telemetry", true, false);

// 方式二：创建Meter时使用指定的名称
m_meter = new Meter("Prototype", "8.1");

移到循环外创建ObservableGauge

// 类成员变量
private ObservableGauge<int> m_observableGauge;

// 初始化阶段创建
m_observableGauge = m_meter.CreateObservableGauge("gauge", () =>
{
    return new List<Measurement<int>>()
    {
        new Measurement<int>(9999999, new KeyValuePair<string, object>("tag1", "value1"))
    };
});

// 循环内仅执行指标更新操作
m_histogram?.Record(Counter);
m_counter?.Add(Counter);
// ...其他指标操作
m_meterProvider.ForceFlush();

内容的提问来源于stack exchange，提问作者Yossi G.