Net8_WebAPI性能监控-MiniProfiler与Swagger集成

郑子铭

发布于 2024-12-09 12:44:43

8200

代码可运行

文章被收录于专栏：DotNet NB && CloudNativeDotNet NB && CloudNative

运行总次数：0

代码可运行

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

1. 安装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" />

1. 配置服务：
- • 在Startup.cs的ConfigureServices方法中添加MiniProfiler服务配置：

services.AddMiniProfiler(options =>
{
    options.RouteBasePath = "/profiler";
})
.AddEntityFramework();

• 在Configure方法中启用MiniProfiler中间件，确保它在UseEndpoints方法之前被调用：

app.UseMiniProfiler();

1. 配置Swagger UI：
- • 下载自定义的Swagger UI页面（例如从GitHub上的xuke353/swaggerui项目，参考：https://www.cnblogs.com/xuke/p/13847248.html ）并将其放置在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为你的项目命名空间。

1. 获取MiniProfiler HTML代码片段：
- • 在一个控制器中添加一个方法来获取MiniProfiler的HTML代码片段：

[HttpGet]
public IActionResult GetCounts()
{
    var html = MiniProfiler.Current.RenderIncludes(_accessor.HttpContext);
    return Ok(html.Value);
}

• 你也可以通过断点调试来获取这段HTML代码。

public IEnumerable<WeatherForecast> GetAll2()
{
    using (MiniProfiler.Current.Step("获取成功后，开始处理最终数据"))
    {
        // 一些逻辑... 
        using (MiniProfiler.Current.Step("准备数据"))
        {
            using (MiniProfiler.Current.CustomTiming("SQL", "SELECT * FROM Config"))
            {
                // 模拟一个SQL查询
                Thread.Sleep(500); 
            }
        }

    }
    var datas = Enumerable.Range(1, 5).Select(index => new WeatherForecast
    {
        Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
        TemperatureC = Random.Shared.Next(-20, 55),
        Summary = Summaries[Random.Shared.Next(Summaries.Length)]
    });

    return datas;
}

1. 将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'; // 设置 ID
    newScript.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);
});