Fast.Logging
参考源码版本 3.5.39;目标 net8.0、net9.0、net10.0;依赖 Fast.Runtime。扩展 ASP.NET Core 日志、控制台格式及按级别分文件输出。
从旧版升级且使用平台标志时,见 Runtime H5 迁移说明。本包的版本对齐记录见依赖链变更。
dotnet add package Fast.Logging注册与选项
AddLoggingService(IServiceCollection services, IConfiguration configuration, string section = "Logging:Fast") 返回服务集合,绑定 LoggingSettingsOptions、注册控制台格式与符合级别的文件 Provider,并添加启动过滤器。
| 字段 | 后配置默认值 |
|---|---|
FileFormat | /{0:yyyy}/{0:MM}/{0:dd}/{0:HH} |
FileSizeLimit | 10485760 字节,即 10 MiB |
MiniLogLevel | LogLevel.Information,注意公开名称是 MiniLogLevel |
EnableCritical | false,Critical 文件输出另受此开关控制 |
文件名基于 logs/<level><FileFormat>.log。目录权限、容量和保留策略由宿主负责;仅安装包不保证文件成功写入。
以下为消费端 Program.cs,使用 Microsoft.NET.Sdk.Web,目标选择本页列出的 .NET 8、9 或 10,并安装上方指定包。app.Run() 表示正常宿主启动;本次文档维护不会执行它。
using Fast.Logging;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using Microsoft.AspNetCore.Builder;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddLoggingService(builder.Configuration);
var app = builder.Build();
app.Logger.LogInformation("Application configured");
app.MapGet("/health", () => "healthy");
app.Run();
public sealed class Worker(ILogger<Worker> logger)
{
public void Report(int count) => logger.LogInformation("Processed {Count} items", count);
}公开 API
| API / 类型 | 使用方式 |
|---|---|
Log.Information/Warning/Error/Debug/Trace/Critical | 消息与参数重载,另有 EventId、Exception 和泛型日志类别版本 |
Log.CreateLogger<T>() | 返回 ILogger,依赖模块的服务上下文 |
Log.CreateLoggerFactory(Action<ILoggingBuilder> configure = null) | 创建工厂;调用者注意工厂生命周期与释放 |
Log.ScopeContext(...) | 接收字典、Action<LogContext> 或 LogContext,返回 (ILogger logger, IDisposable scope);必须释放 scope |
Log.Default() / StringLoggingPart | 构造链式日志片段,最终按公开链式 API 输出 |
LogContext、LogContextExtension | 结构化日志上下文 |
LogMessage、LogMessageExtension、LoggerFormatter | 日志消息与格式化支持 |
LoggingContext | 框架日志上下文入口,不替代请求作用域 |
控制台格式器通过 Provider 提供的 TextWriter 写入;重定向与颜色由 Provider 协调。文件与异常输出可能包含调用方传入的数据,业务代码需在进入日志前处理敏感字段,不能依赖格式器自动删除凭据。
来源与验证
依据 注册实现、日志入口。本轮未编译示例、未创建日志文件或验证平台终端行为。
本次版本调整
自 Fast.Logging 3.5.34 起,使用标准空参数校验辅助方法检查 formatter 和 logger。空值仍抛出 ArgumentNullException,参数名称不变;日志输出协议、文件格式和 Provider 管道没有本次行为调整。
2026-11-02 依赖链变更
2026-11-02 依赖链同步:本包从 3.5.38 递增至 3.5.39,依赖更新为 Fast.Runtime 3.5.37。本模块自身实现与公开声明未变。Runtime 新增移动端 H5,并将 Android 及后续位依次后移;数字协议和掩码须迁移,消费端须重新编译并同步前端枚举,见 Runtime H5 迁移说明。
2026-10-24 版本与依赖
2026-10-24 将本包从 3.5.35 递增至 3.5.36,依赖更新至 Fast.Runtime 3.5.34。本模块自身实现和公开声明未改。
使用 AppEnvironmentEnum 的消费端需按 Runtime 鸿蒙迁移说明迁移数值并重新编译。本轮只核对源码与 MSBuild 有效包元数据,按要求不运行测试,也未执行还原、构建、打包或消费端运行验证。
