Microsoft.Extensions.Diagnostics.ResourceMonitoring中IResourceMonitor弃用后的替代方案

一、弃用提示的含义 #

IResourceMonitor被弃用是因为官方转向了**基于可观测性仪表（Observable Instruments）**的指标采集模式。原API是同步拉取式的单次查询，新方案则采用符合.NET Metrics标准的异步事件驱动模式，更适合持续监控场景，能无缝对接现代监控生态，同时支持指标聚合、多维度标签等高级特性。

二、替代方案：使用Resource Monitoring的Observable Instruments #

无需更换NuGet包，依然使用Microsoft.Extensions.Diagnostics.ResourceMonitoring，只需调整代码逻辑，通过监听库自动发布的标准指标来获取资源数据。以下是完整的控制台应用示例：

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Diagnostics.ResourceMonitoring;
using System.Diagnostics.Metrics;
using System.Linq;

var services = new ServiceCollection()
    .AddLogging(builder => builder.AddConsole())
    .AddResourceMonitoring(options =>
    {
        // 自定义指标采集间隔，默认10秒
        options.SamplingInterval = TimeSpan.FromSeconds(3);
        // 可选：配置资源阈值告警（如需）
        options.CpuUsageThresholds = new CpuUsageThresholds { Warning = 0.7, Critical = 0.9 };
    });

var provider = services.BuildServiceProvider();

// 初始化指标监听器，监听Resource Monitoring发布的所有指标
using var metricListener = new MetricListener();
metricListener.InstrumentPublished = (instrument, listener) =>
{
    // 只监听目标库的指标
    if (instrument.Meter.Name == "Microsoft.Extensions.Diagnostics.ResourceMonitoring")
    {
        listener.EnableMeasurementEvents(instrument);
    }
};

// 处理指标数据
metricListener.MeasurementsRecorded = (instrument, measurements, _) =>
{
    foreach (var measurement in measurements)
    {
        // 按需处理不同类型的资源指标
        switch (instrument.Name)
        {
            case "system.cpu.utilization":
                Console.WriteLine($"CPU使用率: {measurement.Value:P2}");
                break;
            case "system.memory.utilization":
                Console.WriteLine($"内存使用率: {measurement.Value:P2}");
                break;
            case "system.disk.utilization":
                var diskPartition = measurement.Tags.First(t => t.Key == "disk").Value;
                Console.WriteLine($"磁盘[{diskPartition}]使用率: {measurement.Value:P2}");
                break;
            case "system.network.io.utilization":
                var networkInterface = measurement.Tags.First(t => t.Key == "interface").Value;
                Console.WriteLine($"网络[{networkInterface}]IO使用率: {measurement.Value:P2}");
                break;
        }
    }
};

Console.WriteLine("资源监控已启动，按任意键退出...");
Console.ReadKey();

关键说明 #

1. 自动采集：库会自动处理跨平台的底层资源读取逻辑，包括Linux的cgroup环境，无需手动实现
2. 事件驱动：指标更新时自动触发回调，比原同步拉取更高效，适合持续监控
3. 多维度标签：指标附带标签信息（如磁盘分区、网络接口），可精准区分不同资源
4. 可配置性：通过AddResourceMonitoring的配置项可调整采集间隔、资源阈值等参数

内容的提问来源于stack exchange，提问作者Rob L