当前位置：首页 > news >正文

WebAPI性能监控-MiniProfiler与Swagger集成

news 2025/7/7 3:45:12

Net8_WebAPI性能监控-MiniProfiler与Swagger集成

要在.NET Core项目中集成MiniProfiler和Swagger，可以按照以下步骤操作：

安装NuGet包：
- 安装MiniProfiler.AspNetCore.Mvc包以集成MiniProfiler。
- 安装MiniProfiler.EntityFrameworkCore包以监控EF Core生成的SQL语句（可选）。

    <PackageReference Include="MiniProfiler.AspNetCore.Mvc" Version="4.3.8" /><PackageReference Include="Swashbuckle.AspNetCore" Version="6.5.0" />

配置服务：
- 在Startup.cs的ConfigureServices方法中添加MiniProfiler服务配置：
```
services.AddMiniProfiler(options =>
{options.RouteBasePath = "/profiler";
})
.AddEntityFramework();
```
- 在Configure方法中启用MiniProfiler中间件，确保它在UseEndpoints方法之前被调用：
```
app.UseMiniProfiler();
```
配置Swagger UI：
- 下载自定义的Swagger UI页面（例如从GitHub上的xuke353/swaggerui项目）并将其放置在API项目的根目录下，设置文件属性为“嵌入的资源”。
- 修改Startup.cs中的UseSwaggerUI中间件配置，使用自定义的index.html文件：
```
app.UseSwaggerUI(c =>
{c.IndexStream = () => GetType().GetTypeInfo().Assembly.GetManifestResourceStream("YourNamespace.index.html");c.RoutePrefix = string.Empty;c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
});
```
- 确保替换YourNamespace为你的项目命名空间。
获取MiniProfiler HTML代码片段：
- 在一个控制器中添加一个方法来获取MiniProfiler的HTML代码片段：
```
[HttpGet]
public IActionResult GetCounts()
{var html = MiniProfiler.Current.RenderIncludes(_accessor.HttpContext);return Ok(html.Value);
}
```
- 你也可以通过断点调试来获取这段HTML代码。
将HTML代码片段添加到Swagger UI：
- 将获取到的HTML代码片段粘贴到自定义的Swagger UI的index.html文件的顶部。

会出现流访问异常，就是不能再开个swagger进行访问
An unhandled exception occurred while processing the request.
ArgumentException: Stream was not readable.
System.IO.StreamReader…ctor(Stream stream, Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize, bool leaveOpen)

解决方法

                app.UseSwaggerUI(c => {c.InjectJavascript("/custom.js");}

然后再wwwroot文件夹下创建 custom.js，将生成的Javascript进行更改即可

custom.js

// 等待 DOM 完全加载
document.addEventListener('DOMContentLoaded', function () {// 创建一个新的 script 元素var newScript = document.createElement('script');// 设置 script 的属性newScript.async = true; // 设置为异步加载newScript.id = 'mini-profiler'; // 设置 IDnewScript.src = '/profiler/includes.min.js?v=4.3.8+1120572909'; // 设置脚本的源文件路径newScript.setAttribute('data-version', '4.3.8+1120572909');newScript.setAttribute('data-path', '/profiler/');newScript.setAttribute('data-current-id', '551f7bde-3d0b-4fe1-8cef-c6945f6f4d58');newScript.setAttribute('data-ids', 'a264a19a-395d-4e61-970f-6249ab868614,d26da3fb-eca3-4ada-899b-e85058c6010b,8dc76f68-5c1c-495d-95d0-5f07258aacf1,70f16caa-76de-4cd0-a957-82849d471053,41628017-8871-4b2a-af0c-5dfc2a6424cd,51df7af6-93ee-44b1-ba70-97920acbd3b9,4cee7860-8154-4897-81d7-7436c7408778,ba92e686-e4e3-4af6-8329-3c14645998b8,dbe17478-119b-49e3-bd4b-a83fe182354d,551f7bde-3d0b-4fe1-8cef-c6945f6f4d58');newScript.setAttribute('data-position', 'Left');newScript.setAttribute('data-scheme', 'Light');newScript.setAttribute('data-authorized', 'true');newScript.setAttribute('data-max-traces', '15');newScript.setAttribute('data-toggle-shortcut', 'Alt+P');newScript.setAttribute('data-trivial-milliseconds', '2.0');newScript.setAttribute('data-ignored-duplicate-execute-types', 'Open,OpenAsync,Close,CloseAsync');// 将 script 元素添加到文档的 head 中document.head.appendChild(newScript);
});