ASP.NET Core 6如何演示请求跟踪实例详解？

本文共计753个文字，预计阅读时间需要4分钟。

很多人可能对ASP.NET Core自身的诊断日志和性能监控不够重视，但实际上这些日志对错误排查和性能监控提供了非常有用的信息。如果需要创建一个APM（Application Performance Management）系统来监控ASP.NET Core，以下是一个简化的开头内容：

ASP.NET Core的诊断日志和性能监控是确保应用稳定性和高效性的关键。这些日志不仅帮助快速定位错误，还能提供性能监控的宝贵数据。构建一个APM系统，可以实现对应用的全面监控，从而提升应用的可靠性。

很多人可能对ASP.NET Core框架自身记录的诊断日志并不关心，其实这些日志对纠错排错和性能监控提供了很有用的信息。如果需要创建一个APM（Application Performance Management）系统来监控ASP.NET Core应用处理请求的性能及出现的异常，我们完全可以将HostingApplication对象记录的日志作为收集的原始数据。实际上，目前很多APM（如OpenTelemetry.NET 、Elastic APM和SkyWalking APM等）针对都是利用这种方式收集分布式跟踪日志的。

很多人可能对ASP.NET Core框架自身记录的诊断日志并不关心，其实这些日志对纠错排错和性能监控提供了很有用的信息。如果需要创建一个APM（Application Performance Management）系统来监控ASP.NET Core应用处理请求的性能及出现的异常，我们完全可以将HostingApplication对象记录的日志作为收集的原始数据。实际上，目前很多APM（如OpenTelemetry.NET 、Elastic APM和SkyWalking APM等）针对都是利用这种方式收集分布式跟踪日志的。(本篇提供的实例已经汇总到《ASP.NET Core 6框架揭秘-实例演示版》）

[S1701]ASP.NET针对请求的诊断日志（源代码）
[S1702]收集DiagnosticSource输出的日志（源代码）
[S1703]收集EventSource输出的日志（源代码）

[S1701]ASP.NET针对请求的诊断日志

为了确定什么样的信息会被作为诊断日志记录下来，我们通过一个简单的实例演示将HostingApplication对象写入的诊断日志输出到控制台上。HostingApplication对象会将相同的诊断信息以三种不同的方式进行记录，其中包含第8章“诊断日志（中篇）”介绍的日志系统。如下的演示程序利用WebApplicationBuilder的Logging属性得到返回的ILoggingBuilder对象，并调用它的AddSimpleConsole扩展方法为默认注册的ConsoleLoggerProvider开启了针对日志范围的支持。我们最后调用IApplicationBuilder接口的Run扩展方法注册了一个中间件，该中间件在处理请求时会利用依赖注入容器提取出用于发送日志事件的ILogger<Program>对象，并利用它写入一条Information等级的日志。如果请求路径为“/error”，那么该中间件会抛出一个InvalidOperationException类型的异常。

var builder = WebApplication.CreateBuilder(args); builder.Logging.AddSimpleConsole(options => options.IncludeScopes = true); var app = builder.Build(); app.Run(HandleAsync); app.Run(); static Task HandleAsync(HttpContext {request.Host}{request.PathBase}{request.Path}"); localhost:5000/foobar”和“ localhost:5000/error”对应用程序发送两个请求，从输出结果可以看出，应用程序针对前者的处理过程会发出RequestStart事件和RequestStop事件，针对后者的处理则会因为抛出的异常发出额外的事件UnhandledException。输入“Ctrl+C”关闭应用后，名称为HostStop的事件被发出。对于通过EventSource发出的五个事件，只有RequestStart事件会将请求的HTTP方法（GET）和路径（“/foobar”和“/error”）作为负载内容，其他事件都不会携带任何负载内容。

图3　利用注册EventListener监听器获取诊断日志