Galosys.Foundation.MiniProfiler 26.8.3.1

Galosys.Foundation.MiniProfiler

成熟度: 🟡 可用 — 功能完整，测试或文档可能不完善

MiniProfiler 集成模块，为 ASP.NET Core 应用提供性能分析、SQL 监控和请求追踪能力。

功能概览

1. 性能分析

• HTTP 请求性能监控
• SQL 查询性能追踪
• MVC 过滤器与视图性能分析
• 连接打开/关闭追踪

2. 可视化界面

• 实时性能数据展示
• SQL 格式化显示
• 深色主题支持
• 路由路径可配置

3. Entity Framework Core 集成

• EF Core 查询性能监控
• 自动生成 SQL 日志
• 查询执行时间统计

安装

<PackageReference Include="Galosys.Foundation.MiniProfiler" Version="x.x.x" />

使用

注册服务

// 在 Startup.cs 或 Program.cs 中注册
services.AddMiniProfiler();

配置选项

services.AddMiniProfiler(options =>
{
    // 路由路径配置
    options.RouteBasePath = "/profiler";
    
    // 缓存时间配置
    (options.Storage as MemoryCacheStorage).CacheDuration = TimeSpan.FromMinutes(60);
    
    // SQL 格式化器
    options.SqlFormatter = new StackExchange.Profiling.SqlFormatters.InlineFormatter();
    
    // 连接追踪
    options.TrackConnectionOpenClose = true;
    
    // 主题颜色
    options.ColorScheme = StackExchange.Profiling.ColorScheme.Dark;
    
    // MVC 过滤器性能分析
    options.EnableMvcFilterProfiling = true;
    
    // MVC 视图性能分析
    options.EnableMvcViewProfiling = true;
})
.AddEntityFramework();

使用 MiniProfileService

// 控制器自动注入
[RestController, AllowAnonymous]
public class MiniProfileService
{
    private readonly IHttpContextAccessor _accessor;

    public MiniProfileService(IHttpContextAccessor accessor)
    {
        _accessor = accessor;
    }

    public HtmlString Html()
    {
        return MiniProfiler.Current.RenderIncludes(_accessor.HttpContext);
    }
}

在视图中显示性能数据

@using StackExchange.Profiling
@inject IHttpContextAccessor HttpContextAccessor

@{
    var profiler = MiniProfiler.Current;
    if (profiler != null)
    {
        @profiler.RenderIncludes(HttpContextAccessor.HttpContext)
    }
}

核心类

配置说明

路由配置

• 默认路径: /profiler
• 可通过 RouteBasePath 自定义

存储配置

• 默认: 内存缓存
• 缓存时间: 60 分钟
• 支持自定义存储实现

SQL 格式化

• InlineFormatter: 内联格式化（默认）
• SqlServerFormatter: SQL Server 格式化
• 支持自定义格式化器

颜色主题

• ColorScheme.Light: 浅色主题
• ColorScheme.Dark: 深色主题（默认）

依赖项

• miniprofiler.aspnetcore.mvc
• miniprofiler.entityframeworkcore
• Galosys.Foundation.AspNetCore.DynamicApi
• Galosys.Foundation.Core

目录结构

Galosys.Foundation.MiniProfiler/
├── Galosys/Foundation/MiniProfiler/
│   └── MiniProfileService.cs
└── Microsoft/Extensions/DependencyInjection/
    └── ServiceCollectionExtensions.cs

注意事项

1. 生产环境部署: 建议配置授权规则，限制性能分析数据的访问
2. 内存占用: 长时间运行的应用建议调整缓存时间
3. SQL 日志: 大量 SQL 查询可能影响性能，建议仅在开发环境启用详细日志
4. 跨域支持: 确保 /profiler 路由的跨域配置正确

示例项目

参考 samples/Dev.API 项目中的 MiniProfiler 集成示例。