prometheus-net是一个用于在 .NET 应用程序中生成和导出指标数据到Prometheus的库。支持多种运行时环境，包括：摘要：该库提供了丰富的功能，帮助开发者轻松地将应用程序的性能和行为指标暴露给 Prometheus 监控系统。
• .NET Framework 4.6.2
• .NET 6.0
该库提供了丰富的功能，帮助开发者轻松地将应用程序的性能和行为指标暴露给 Prometheus 监控系统。
• Counter（计数器）：只能递增或重置的指标，适用于统计请求总数、处理任务数量等。
• Gauge（仪表盘）：可以任意变化的指标，适用于表示当前状态，如队列中的任务数量。
• Histogram（直方图）：跟踪事件的分布情况，适用于分析请求延迟、响应大小等。
• Summary（摘要）：跟踪事件的趋势，适用于记录请求大小、持续时间等。
高级功能• 操作持续时间测量：通过Timer测量操作的执行时间，并将结果记录到 Summary 或 Histogram 中。
• 进行中的操作跟踪：使用Gauge.TrackInProgress跟踪并发操作的数量。
• 异常计数：通过Counter.CountExceptions记录代码执行过程中发生的异常数量，并可选择性过滤特定类型的异常。
标签（Labels）所有指标都可以使用标签来区分不同的维度。例如，可以通过 HTTP 方法对请求计数器进行分组：
privatestaticreadonlyCounter RequestCountByMethod = Metrics.CreateCounter("myapp_requests_total", "Number of requests received, by HTTP method.", labelNames:new { "method" });
// 使用标签记录 GET 请求
RequestCountByMethod.WithLabels("GET").Inc;示例（Exemplars）prometheus-net支持将分布式追踪信息附加到指标上，方便通过 Prometheus 和 Grafana 等工具进行可视化分析。示例功能允许你将trace_id和span_id附加到指标上，从而关联到具体的调用链路。自动指标删除对于具有高基数（大量不同标签组合）的指标，prometheus-net提供了自动删除机制。你可以通过WithManagedLifetime创建具有生命周期管理的指标，当某个指标不再被更新时，会自动从内存中移除。ASP.NET Core 集成prometheus-net.AspNetCore包含了与 ASP.NET Core 的深度集成，支持以下功能：
• HTTP 请求指标：记录请求总数、并发请求数、请求持续时间等。
• gRPC 请求指标：记录 gRPC 服务的调用次数、持续时间等。
• 健康检查状态指标：将 ASP.NET Core 健康检查的状态暴露为 Prometheus 指标。
• IHttpClientFactory 指标：记录通过IHttpClientFactory发起的 HTTP 请求的相关信息。
推送网关支持除了通过端点暴露指标外，prometheus-net还支持将指标推送到Prometheus Pushgateway，适用于短生命周期的任务或无法直接被 Prometheus 抓取的应用场景。自定义指标发布如果你需要自定义指标发布的逻辑，prometheus-net提供了灵活的接口，允许你通过AddBeforeCollectCallback注册回调函数，在每次收集指标前执行自定义逻辑。NuGet 安装• 通用用途及 HttpListener/ Pushgateway 支持：
Install-Package prometheus-net• ASP.NET Core 中间件及 Kestrel 独立服务器支持：
Install-Package prometheus-net.AspNetCore• ASP.NET Core 健康检查集成：
Install-Package prometheus-net.AspNetCore.HealthChecks• ASP.NET Core gRPC 集成：
Install-Package prometheus-net.AspNetCore.Grpc• ASP.NET Web API 中间件（.NET Framework）：
Install-Package prometheus-net.NetFramework.AspNet快速入门控制台应用示例usingvarserver =newPrometheus.KestrelMetricServer(port:1234);server.Start;
Console.WriteLine("Open http://localhost:1234/metrics in a web browser.");
Console.WriteLine("Press enter to exit.");
Console.ReadLine;ASP.NET Core 应用在方法中启用 Prometheus 中间件：publicvoidConfigure(IApplicationBuilder app, IHostingEnvironment env)
{
// 启用 Prometheus HTTP 请求指标
app.UseHttpMetrics;
// 启用 Prometheus gRPC 请求指标
app.UseGrpcMetrics;
// 启用 Prometheus 健康检查指标
app.UseHealthChecks("/health");
// 启用 Prometheus 指标端点
app.UseEndpoints(endpoints =>
{
endpoints.MapMetrics;
});
}
来源：opendotnet
