ASP.NET Core 1.0基础之诊断
来自: http://www.cnblogs.com/yanbinliu/p/5173206.html
来源https://docs.asp.net/en/latest/fundamentals/diagnostics.html
ASP.NET Core 1.0包含了一些新的特性来辅助诊断问题。可以在Startup类中轻易地配置不同的handler来处理应用程序错误,显示额外信息。
配置错误处理页面
ASP.NET Core 1.0中可以在Startup类的Configure方法中为每个Request请求配置处理管道。在开发中,你可以非常方便地配置一个简单的错误处理页面。你只需要添加项目对Microsoft.AspNet.Diagnostics的依赖,然后在Configure方法中添加一行代码。
using Microsoft.AspNet.Builder; using Microsoft.AspNet.Diagnostics; using Microsoft.AspNet.Hosting; using Microsoft.AspNet.Http; using System; using Microsoft.Extensions.DependencyInjection; namespace DiagDemo { public class Startup { // For more information on how to configure your application, visit http://go.microsoft.com/fwlink/?LinkID=398940 public void ConfigureServices(IServiceCollection services) { } public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (string.Equals(env.EnvironmentName, "Development", StringComparison.OrdinalIgnoreCase)) { app.UseDeveloperExceptionPage(); app.UseRuntimeInfoPage(); // default path is /runtimeinfo } else { // specify production behavior for error handling, for example: // app.UseExceptionHandler("/Home/Error"); // if nothing is set here, exception will not be handled. } app.UseWelcomePage("/welcome"); app.Run(async (context) => { if(context.Request.Query.ContainsKey("throw")) throw new Exception("Exception triggered!"); context.Response.ContentType = "text/html"; await context.Response.WriteAsync("<html><body>Hello World!"); await context.Response.WriteAsync("<ul>"); await context.Response.WriteAsync("<li><a href=\"/welcome\">Welcome Page</a></li>"); await context.Response.WriteAsync("<li><a href=\"/?throw=true\">Throw Exception</a></li>"); await context.Response.WriteAsync("</ul>"); await context.Response.WriteAsync("</body></html>"); }); } } }
如上代码是在ASP.NET Core 1.0中的空模板中创建的,只包含了简单异常处理产生机制(在36行)。如果querystring的“throw” key的值不为空,就会抛出异常。然后会调用21行的UseDeveloperExceptionPage方法,来调用中间件。
注意到调用UseDeveloperExceptionPage在包含在if代码块中间的,会先检查当前环境。这是很好的实践方式,因为你可能不愿意在生产环境中公开展示程序诊断信息。if语句会使用ASPNET_ENV环境变量,如果你使用的VS2015,你可以在web项目属性中自定义环境变量。如下
将ASPNET_ENV 设置任何非Development的值,应用都不会调用UseDeveloperExceptionPage方法,而是返回500错误(没有任何详细信息,除非你配置了UseExceptionHandler())。在下面我们会看到error page所提供的特性(确保ASPNET_ENV被设置回Development)。
在开发中使用error page
在web处理管道中发生未处理异常时,默认error page会显示一些有用的诊断信息。error page有几个tab来显示请求中异常相关的信息。第一个tab显示stack trace
第二tab显示Querystring 相关的信息
如上,你可以看到请求中传递的throw参数的值。本次请求没有cookie,如果有的话,会在Cookies tab中。你可以看到传递的headers的值,如下。
Note:当前pre-release版本,ErrorPage的Cookies部分还不可用。详见 ErrorPage Source 。
Azure上的Http 500错误
略
运行时info page
除了配置和显示错误页面外,你也可以通过调用扩展方法UseRuntimeInfoPage来添加运行时信息页面。如下代码,就可以开启该功能。
app.UseRuntimeInfoPage();
一旦添加了如上代码,你就可以输入/runtimeinfo来查看运行时信息、包信息等。如下。
当然这个请求路径是可以更改的,你可以在调用UseRuntimeInfoPage()方法时指定。这个方法接收一个 RuntimeInfoPageOptions实例作为参数,它有一个Path属性。例如,指定/info路径,你可以像如下调用UseRuntimeInfoPage。
app.UseRuntimeInfoPage("/info")
同UseDeveloperExceptionPage()扩展方法一样,限制公共对诊断信息的获取。因此本例中,值在开发环境中调用UseRuntimeInfoPage()方法。
Note:记住Startup类中的Configure方法定义的管道对所有的请求都是有效的,因此管道配置顺序是很重要的。例如,如果你把UseRuntimeInfoPage()的调用放在app.Run()之后,则该方法是不会被调用的。因为app.Run会在调用UseRuntimeInfoPage之前处理请求。
welcome页面
另一个有用的扩展方法是UseWelcome(),尤其是你在第一次运行ASP.NET Core 1.0程序时。配置如下。
app.UseWelcome()
一旦调用该方法,它会处理所有请求,并返回很cool的hello页面(默认情况下)。如下。
你也可以配置欢迎页面只响应某些路径(和UseRuntimeInfoPage类似)。如下代码配置了欢迎页面只响应/welcome路径(别的请求路径将会忽略,转交给下个管道handler)。
app.UseWelcomePage("/welcome");
按照本文如上配置Configure方法,将会按如下方式响应请求。
Path | Result | /runtimeinfo | UseRuntimeInfoPage will handle and display runtime info page |
---|---|---|---|
/welcome | UseWelcomePage will handle and display welcome page | ||
paths without ?throw= | app.Run() will respond with “Hello World!” | ||
paths with ?throw= | app.Run() throws an exception; UseErrorPage handles, displays an error page |
Summary
在ASP.NET Core 1.0中,你可以很简单的添加error page,查看diagnostic信息,或者简单的响应一个欢迎页面。
</div>