ASP.NET CORE MVC用时分析工具MiniProfiler

ASP.NET CORE MVC用时分析工具MiniProfiler

MiniProfiler(https://miniprofiler.com/)是一个轻量级且简单易用的分析工具库,它可以用来分析ASP.NET Core应用。

优点

针对ASP.NET Core MVC应用,使用MiniProfiler的优点是:它会把结果直接放在页面的左下角,随时可以点击查看;这样的话就可以感知出你的程序运行的怎么样;同时这也意味着,在你开发新功能的同时,可以很快速的得到反馈。

 

安装配置MiniProfiler

在现有的ASP.NET Core MVC项目里,通过Nuget安装:

接下来,想把MiniProfiler配置好,总共分三步😂:

第一步,来到StartUp.cs的ConfigureServices方法里,添加 services.AddMiniProfiler()

当然这个方法还可以添加一个lambda表达式作为参数,从而做一些自定义的配置:

可以看到可用的配置选项还是很多,具体还需要看官方文档。

在这个例子里,我就只使用两个选项吧:

第一行是设定弹出窗口的位置是左下角;第二行是在弹出的明细窗口里会显式Time With Children这列。

 

第二步,来到Startup的Configure方法里,添加app.UseMiniProfiler()

最重要的一点是,一定要把它放在UseMvc()方法之前。 

这里就是配置中间件在管道中的位置,想必大家都了解。

 

第三步,就是把MiniProfiler的Tag helper放到页面上

这里还分两步:

1. 在_ViewImports里面把它的Tag Helper全引入进来:

 

一共又有两行代码:

@using StackExchange.Profiling
@addTagHelper *, MiniProfiler.AspNetCore.Mvc

 

2.最后,需要把MiniProfiler的Tag Helper放在_Layout.cshtml里

放在这里的话,每个页面就都能看到它了。

其实放在这个页面的什么地方都应该可以,但是由于它会加载一些脚本文件,所以我放在footer下面:

 

运行应用,可以看到左下角就是MiniProfiler:

 

点击它之后会弹出窗口:

这里面有每个步骤具体的耗用时间。

 

分析局部代码

前面的例子里,我们使用MiniProfiler分析了页面整个流程的时间。而MiniProfiler也可以用来分析一段代码所耗用的时间。看例子:

(注意,如果这段代码不在主Web项目里,你需要在那段代码所在的项目添加MiniProfiler.AspNetCore这个库)

然后这样用就可以了:

这里我们使用了using语句,里面使用了MiniProfiler类的Current属性,在该属性上面有一个Step()方法,它可以用来分析using语句里面的代码,在Step方法里,要提供一个具有描述性的名称来表示该段代码做的是什么动作,这个名称会显示在结果里。

 

通常,我会嵌套着使用:

如果你只想分析一句话,那么使用using语句就显得太麻烦了,这种情况下可以使用Inline()方法:

该方法可以保证得到的结果是相同类型的。

 

运行程序,点击左下角的按钮:

可以看到刚才那几块代码的分析结果按照其嵌套解构展示出来了。

 

自定义分析 CustomTiming

有时候,分析一些例如请求外部动作的时候,上面讲的做法可能不太灵光,这里我们就可以使用CustomTiming()方法。

直接看例子:

这个例子里,我们使用了MiniProfiler.Current.CustomTiming()方法。方法第一个参数是一个用于分类的字符串,由于我这个例子是http请求,所以第一个参数我写的是http;第二个参数是命令字符串,暂时留空,第三个参数是执行类型,这里我是用的是HTTPGet,所以就写了GET。

然后在response返回之后,我再把命令字符串给补上。这里就需要引用一下CustomTiming()方法返回的对象,所以在using语句里我添加了一个变量timing。在response返回后,我设置了timing变量的命令字符串为URL和返回的状态码,因为我感觉这样写才可以更准确的表明这次动作。而状态码只有response返回之后才有,所以在using语句里调用CustomTiming()方法时,我暂时把第二个命令设置为空字符串。

 

运行程序,可以看到弹出窗口的右侧出现了http这一列:

点击这个1437.7(1),会再弹出一个窗口:

可以看到这就是我们使用CustomTiming分析的那段代码,URL和返回码都显示了出来。

 

如果需要分析所有的HttpClient的请求,那么你可以在Http管道里放一个DelegatingHandler,具体说就是创建一个类,继承于DelegatingHandler,只需要重写一个叫做SendAsync的方法,把分析的代码写在这个方法里即可,最后需要在HttpClientFactory里面进行配置。这部分代码我先不写,以后再说。

而如果不是HttpClient的请求,那么你可以自己写一个Wrapper或通过装饰者设计模式来实现。。。

 

在WebApi项目里使用MiniProfiler并且分析 Entity Framework Core

我换了一个ASP.NET Core Web API的解决方案,它用到了Entity Framework Core。

基本配置和上面是一样的,只不过不需要使用TagHelper了。

需要安装MiniProfiler.EntityFrameworkCore,注意不管使用EFCore的项目在哪,你还是需要把这个库安装在主Web项目里:

首先添加一个配置选项,用于访问分析结果;然后在之前的配置后边加上AddEntityFramework()即可:

 

运行程序,这时一共有三个查看分析结果相关的URL地址:

  • /profiler/results-index
  • /profiler/results
  • /profiler/results-list

 先看results-index:

什么也没有,这时因为我还没有调用任何API,接下来就调用一个API,然后再查看该页面:

这个页面自动刷新了,出现了刚才调用API的结果。可以看到总时间为3066毫秒。

 

再看result-list页面:

其实就是分析结果的json数据。

 

最后从result-index页面点击链接进入这次API调用的详细结果页面,也就是result页面:

最上面列表的最后一列括号外的数据是执行SQL语句的总耗时,而括号里面是指一共执行了4个语句。

下面那一大片就是整个过程中每步的分析结果明细,这里包含了四个SQL语句,但是截图不全。

 

对分析结果进行访问控制

你肯定不想让任何人都看到MiniProfiler的分析结果,这就需要你对其进行访问权限控制。

在Startup.cs的ConfigureServices方法里,再添加两个配置:

ResultsAuthorize的参数是一个Func,参数是HttpRequest,返回类型为bool,在这里你就可以写一个函数来判断用户的身份。返回true就代表用户有权限。

UserIdProvider,它的参数也是一个Func,用来为当前请求的用户返回他的ID或用户名(唯一的)。这个项目里我可以使用User.Identity.Name。

 

当用户没登录的时候:

左下角不显示分析结果按钮了。

 

登录一个admin角色的用户以后:

左下角出现了结果,并且只是当前用户操作的分析结果。

 

把分析结果存到数据库

你可能需要把分析结果持久话,例如存到数据库里。

这时你需要安装一个MiniProfiler的存储提供商:

 

我这里使用的是SqlServer,所以安装SqlServer那个:

 

通常这种数据是放在一个单独的数据库里,所以添加一个数据库连接字符串:

 

再来到Startup的ConfigureServices里,获取ConnectionString,然后设置Storage选项即可:

 

最后,还需要创建MiniProfiler所使用的数据库表,这些创建表的SQL语句存在于SqlServerStorage对象的TableCreationScripts里,你可以在程序的某个地方贴上如下代码:

 

然后把SQL语句复制下来并执行,从而生成表😂:

 

执行完以后,表如下:

 

运行程序,调用API,在数据库里面查看数据:

肯定是有数据了,具体就不细看了。

 

就讲到这,谢谢大家。

博客文章可以转载,但不可以声明为原创. 
posted @ 2024-06-18 14:10  China Soft  阅读(52)  评论(0编辑  收藏  举报