在分布式系统里，把各个服务打印的日志集中到一处查询，是定位问题的前提。Seq是一个面向结构化日志的集中管理平台，它不像普通文本日志系统那样只能靠关键字搜，而是能理解每一条日志携带的字段，比如用户ID、请求耗时、订单号等，从而进行精确筛选和聚合。
为什么选择Seq做C#日志集中管理
C#生态里常见的日志框架有NLog、log4net和Serilog，其中Serilog天生支持结构化事件，和Seq配合最自然。传统文件日志把信息拍平成一串文本，出问题时只能靠grep，而Seq接收的是带属性的事件，可以在界面上点选字段直接过滤。
另外，Seq提供了类SQL的查询语言（SigQL），支持按时间范围、日志级别、自定义属性做组合条件检索，还能保存为仪表盘。对于中小团队来说，它既有云端托管版，也能单机私有部署，接入成本很低。
用Serilog把C#日志发送到Seq
第一步是在项目中引入Serilog的Seq接收器。以ASP.NET Core为例，先通过NuGet安装Serilog.AspNetCore和Serilog.Sinks.Seq。然后在Program.cs里配置Serilog，把Seq地址和API Key填好。
下面是一段最小可运行的配置代码，注意里面的<和>在代码块里已转义，实际复制时就是正常尖括号：
using Serilog;
var builder = WebApplication.CreateBuilder(args);
// 配置Serilog输出到控制台和Seq
Log.Logger = new LoggerConfiguration()
.MinimumLevel.Information()
.WriteTo.Console()
.WriteTo.Seq(
serverUrl: "http://localhost:5341",
apiKey: "your-seq-api-key")
.CreateLogger();
builder.Host.UseSerilog();
var app = builder.Build();
app.MapGet("/test", () =>
{
Log.ForContext("UserId", 1001)
.Information("用户执行了查询操作，耗时 {Elapsed} ms", 32);
return "ok";
});
app.Run();
运行后访问/test接口，就能在Seq界面看到一条带UserId和Elapsed字段的日志。比起写string.Format拼文本，这种写法让机器可读、人也可读。
在代码中记录结构化属性
光有级别不够，真实排错常常要看业务维度。Serilog允许用命名占位符把变量变成属性，例如订单处理时可以附上OrderId和Amount：
public void ProcessOrder(Order order)
{
Log.ForContext("OrderId", order.Id)
.Information("开始处理订单，金额 {Amount}", order.Amount);
try
{
// 业务处理
}
catch (Exception ex)
{
Log.ForContext("OrderId", order.Id)
.Error(ex, "订单处理失败，状态 {Status}", order.Status);
}
}
这样在Seq里搜索OrderId = 12345就能拉出该订单全生命周期的日志。注意异常对象要作为第一个参数传给Error方法，Seq会展开异常树。
如果某些属性每次请求都该带，比如TraceId，可以用中间件或LogContext推送，不必每个方法手写。下面展示用LogContext临时附加属性：
using (LogContext.PushProperty("TraceId", Guid.NewGuid().ToString()))
{
Log.Information("在Trace范围内输出的日志都会带TraceId");
}
Seq平台侧的查询与告警配置
日志进到Seq后，在搜索框输入Level >= Error and UserId = 1001就能精确找错。SigQL也支持count()、percentile()等聚合，比如看平均响应时间：
select avg(Elapsed) from stream where Elapsed is not null
把常用查询存为仪表盘，团队开机就能看到错误趋势。告警方面，Seq可以设置当某条件每分钟触发超过N次时发邮件或Webhook，比人工刷日志主动得多。
对于敏感字段，Seq支持在接收端配置脱敏规则，比如把Password属性掩码，避免日志库变成密码泄露源。这一点在合规要求高的系统里很关键。
部署与性能注意点
开发环境可以用Docker一条命令起Seq：docker run -e ACCEPT_EULA=Y -p 5341:80 datalust/seq。生产环境建议分离应用和Seq所在机器，并通过内网域名而非公网暴露，减少风险。
高频日志场景要关注Seq的摄取吞吐，若应用量极大，可在客户端用Serilog.Sinks.Async把写日志操作丢到后台线程，避免阻塞主请求。同时合理设最低级别，Debug日志别全开到生产。
| 方案 | 优点 | 缺点 |
|---|---|---|
| 文件日志+ELK | 生态成熟 | 搭建重，结构化需额外解析 |
| Seq+Serilog | 原生结构化，查询直观 | 大规模需考虑授权费用 |
| 云厂商日志服务 | 免运维 | 字段查询语法不统一 |
总体看，C#项目用Seq做集中日志管理，从接入到检索的链路都很短，特别适合重视排错效率的团队。
C#Seqstructured_logging修改时间：2026-08-09 12:03:29