如何在单元测试中验证Histogram<T>与Counter<T>的调用？

直接通过原生Meter实例无法直接检查Record/Add方法的调用记录，因为原生Meter的设计目标是高效发送遥测数据，并未内置调用追踪机制。但可以通过两种可靠方式实现断言：使用官方提供的测试专用Meter，或通过依赖注入结合Mock框架模拟计量器行为。

方法一：使用.NET官方测试计量器（推荐） #

从.NET 7开始，System.Diagnostics.Metrics.Testing包提供了TestMeter类，专门用于遥测的单元测试，它能完整追踪所有计量器的调用记录，且无需修改原有代码的依赖关系。

操作步骤： #

1. 安装NuGet包：System.Diagnostics.Metrics.Testing
2. 在测试中创建TestMeter实例，替代原生Meter注入到被测代码中
3. 执行被测逻辑后，通过TestMeter获取对应的测试计量器，验证调用情况

代码示例：

using System.Diagnostics.Metrics.Testing;

[Test]
public void Counter_Add_ShouldBeTracked()
{
    // 创建测试专用Meter
    var testMeter = new TestMeter();
    
    // 从测试Meter创建Counter（或注入到被测服务）
    var counter = testMeter.CreateCounter<long>("request.count");
    
    // 执行被测逻辑（示例直接调用Add，实际应为调用被测服务的方法）
    counter.Add(1);
    
    // 获取测试Counter并断言调用结果
    var testCounter = testMeter.GetObservableCounter<long>("request.count");
    Assert.That(testCounter.GetMeasurementValues().Sum(), Is.EqualTo(1));
}

[Test]
public void Histogram_Record_ShouldBeTracked()
{
    var testMeter = new TestMeter();
    var histogram = testMeter.CreateHistogram<double>("response.time");
    
    // 执行被测逻辑
    histogram.Record(250.5);
    
    var testHistogram = testMeter.GetHistogram<double>("response.time");
    var measurements = testHistogram.GetMeasurements();
    Assert.That(measurements.Count, Is.EqualTo(1));
    Assert.That(measurements.First().Value, Is.EqualTo(250.5));
}

方法二：使用Mock框架（如Moq） #

如果你的代码依赖自定义抽象接口（而非直接依赖Counter<T>/Histogram<T>具体类），可以通过Mock框架模拟计量器行为，直接验证方法调用。

操作步骤： #

1. 为计量器定义抽象接口
2. 在被测代码中依赖这些接口，而非具体实现
3. 测试时用Mock创建模拟实例，注入到被测代码后验证调用

代码示例：

// 定义抽象接口
public interface ICounter<T> where T : struct
{
    void Add(T value, params KeyValuePair<string, object?>[] tags);
}

public interface IHistogram<T> where T : struct
{
    void Record(T value, params KeyValuePair<string, object?>[] tags);
}

// 被测服务（依赖抽象接口）
public class RequestService
{
    private readonly ICounter<long> _requestCounter;
    private readonly IHistogram<double> _responseTimeHistogram;

    public RequestService(ICounter<long> requestCounter, IHistogram<double> responseTimeHistogram)
    {
        _requestCounter = requestCounter;
        _responseTimeHistogram = responseTimeHistogram;
    }

    public void ProcessRequest()
    {
        _requestCounter.Add(1);
        _responseTimeHistogram.Record(300.0);
    }
}

// 单元测试
[Test]
public void ProcessRequest_ShouldUpdateMetrics()
{
    // 创建Mock实例
    var mockCounter = new Mock<ICounter<long>>();
    var mockHistogram = new Mock<IHistogram<double>>();
    
    // 注入到被测服务
    var service = new RequestService(mockCounter.Object, mockHistogram.Object);
    
    // 执行被测方法
    service.ProcessRequest();
    
    // 断言方法被正确调用
    mockCounter.Verify(c => c.Add(1, It.IsAny<KeyValuePair<string, object?>[]>()), Times.Once);
    mockHistogram.Verify(h => h.Record(300.0, It.IsAny<KeyValuePair<string, object?>[]>()), Times.Once);
}

注意事项 #

• 原生Meter实例无法直接获取调用记录，不要尝试通过反射等非常规手段去读取，这会破坏代码的稳定性。
• 优先选择官方TestMeter方案，它能完整模拟原生Meter的行为，无需修改原有代码的依赖结构，测试结果更贴近真实场景。

内容的提问来源于stack exchange，提问作者Matthew MacFarland