当前位置:

首页 > 编程开发 > C# Serilog日志上下文使用方法

C# Serilog日志上下文使用方法

LogContext.PushProperty未生效是因为缺少Enrich.FromLogContext()配置;该enricher需全局启用才能使PushProperty的属性出现在日志中,否则上下文属性不会被注入输出。

本文目录

    LogContext.PushProperty未生效是因为缺少Enrich.FromLogContext()配置;该enricher需全局启用才能使PushProperty的属性出现在日志中,否则上下文属性不会被注入输出。

    C# Serilog日志上下文方法 C#如何通过LogContext添加动态属性

    LogContext.PushProperty 为什么没出现在日志里

    直接调用 LogContext.PushProperty("UserId", 123) 后日志没带这个字段,大概率是因为你没在日志配置中启用上下文支持。Serilog 默认不自动注入 LogContext 的属性,必须显式启用——比如用 Enrich.FromLogContext()。

    常见错误是只写了 PushProperty,却漏掉 enricher 配置:

    Log.Logger = new LoggerConfiguration()
        .Enrich.FromLogContext() // ⚠️ 必须加这一行
        .WriteTo.Console()
        .CreateLogger();
    • 没有 Enrich.FromLogContext(),PushProperty 像往水里扔石头,涟漪根本传不到日志输出
    • 该 enricher 是全局生效的,不需要每次写日志都重复配置
    • 它只捕获「当前异步执行流」中的上下文(基于 AsyncLocal),跨线程或新 Task 会丢失

    如何安全地在异步方法中使用 LogContext

    LogContext 的生命周期绑定到当前 ExecutionContext,但不是所有异步场景都自动流动。尤其在 ASP.NET Core 中,Controller 方法里 push 的属性,在 await 后的 lambda 或后台任务里可能已失效。

    推荐做法是:在入口处(如中间件、Controller Action)push,且尽量避免在 Task.Run 或手动切换同步上下文的地方依赖它:

    • ✅ ASP.NET Core 中,在 UseSerilogRequestLogging 中间件前注册 Enrich.FromLogContext(),再配合 LogContext.PushProperty("TraceId", HttpContext.TraceIdentifier)
    • ❌ 不要在 Task.Run(() => { LogContext.PushProperty(...); DoWork(); }) 里 push —— 子线程没有父上下文
    • ⚠️ 若必须跨任务传递,改用显式参数传入,或用 Log.ForContext("UserId", userId) 创建子 logger

    PushProperty 和 ForContext 的关键区别

    二者都能加属性,但作用域和机制完全不同:

    • LogContext.PushProperty("Key", value):把属性压入当前逻辑调用栈,所有后续 Log.Information(...) 都自动携带(只要没被 pop);适合请求级、事务级统一字段
    • Log.ForContext("Key", value).Information(...):仅本次日志事件携带,不污染后续日志;适合单条日志的临时补充,比如记录某个计算结果
    • PushProperty 支持多次同名覆盖(后 push 的生效),而 ForContext 是链式构造新 logger,不影响原 logger
    • 性能上,ForContext 每次新建 logger 对象有开销;PushProperty 是栈操作,更轻量,但需注意别漏 pop 导致内存泄漏(不过 Serilog 内部用 AsyncLocal 管理,通常无需手动 pop)

    动态属性值怎么实时求值(比如当前时间戳或随机 ID)

    PushProperty 默认存的是调用时的值快照。如果想每次日志输出时重新计算(例如生成唯一 ID、取当前毫秒数),得用它的重载版本传入 Func:

    LogContext.PushProperty("LogTime", () => DateTime.Now.ToString("HH:mm:ss.fff"));
    LogContext.PushProperty("RequestId", () => Guid.NewGuid().ToString("N"));

    这样每次日志序列化时都会执行函数,拿到最新值。但要注意:

    • 函数体不能抛异常,否则整条日志会静默失败(Serilog 会吞掉异常)
    • 避免在函数里做 IO 或锁操作,否则拖慢日志性能
    • 不要返回 null,否则该字段不会出现在日志中(可返回 "null" 字符串兜底)

    真正难处理的从来不是怎么加属性,而是上下文在异步分叉、线程切换、DI 生命周期边界处的“消失”——这些地方得靠显式传参或重构日志结构来兜底。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Nod 0.8.1怎样理解状态码、Ray ID与计划检查
    Nod 0.8.1怎样理解状态码、Ray ID与计划检查

    Nod 0.8.1补充连接服务状态与原因、Attio Cloudflare 403诊断,并让Gmail在连接服务429或503后延后计划轮询。

    Ducter 0.0.59如何理解同会话聊天、Git可选和附件变化
    Ducter 0.0.59如何理解同会话聊天、Git可选和附件变化

    Ducter 0.0.59扩展Telegram、Slack和Mac iMessage会话,区分项目目录来源、Git可选、等待状态与附件入口。

    llama.cpp b12435、b12436、b12438测试构建的三类兼容变化有什么区别?
    llama.cpp b12435、b12436、b12438测试构建的三类兼容变化有什么区别?

    llama.cpp b12435、b12436、b12438预发布构建,分别解释Vulkan并列选择确定性、32位编译与Jinja JSON键排序的适用范围。

    ScopeWeaver 0.9.2、0.9.3与0.9.4如何区分运行时、Zod和任务状态变化
    ScopeWeaver 0.9.2、0.9.3与0.9.4如何区分运行时、Zod和任务状态变化

    ScopeWeaver 0.9.2、0.9.3与0.9.4分别调整桥运行时、Zod依赖和同进程服务器重建后的暂停状态;区分版本对象与作者本地研究用途声明。

    AG2 1.3.2的输入Token为何变多,旧ACP版本还能用吗
    AG2 1.3.2的输入Token为何变多,旧ACP版本还能用吗

    AG2 1.3.2统一缓存Token统计并更新ACP1.x依赖;解释预算提前触达、报表口径与Python3.15构建限制。

    llama.cpp b12433怎样为AMD奇数列保留MUL_MAT_ID回退路径
    llama.cpp b12433怎样为AMD奇数列保留MUL_MAT_ID回退路径

    llama.cpp b12433避免AMD设备将奇数src0列送入需要偶数列的MMVF路径:满足偶数条件才保留MMVF,其他形状沿用既有回退。对应改动发生在MUL_MAT_ID处理和相关同步判断中,范围限定于代码说明中的类型与token条件。

    Ducter 0.0.58如何区分下一步消息、完成后消息与后台会话
    Ducter 0.0.58如何区分下一步消息、完成后消息与后台会话

    Ducter 0.0.58调整任务阅读、执行中消息和后台会话,区分下一步发送与做完再说,并说明tailnet HTTPS辅助的条件。

    Unlimited OCR 2在TextMind能否直接使用,账号权限与模型示例如何区分
    Unlimited OCR 2在TextMind能否直接使用,账号权限与模型示例如何区分

    Unlimited OCR 2官方确认百度智能云TextMind渠道;区分云端入口、账号权限配额与本地模型部署,避免混淆接口和计费条件。

    TensorFold 1.2.9的Ollama接口和服务配置文件怎么用
    TensorFold 1.2.9的Ollama接口和服务配置文件怎么用

    TensorFold 1.2.9的服务配置文件用于保存和复用启动参数,Ollama兼容API则在同一推理路径上提供聊天、生成和模型查询等接口。理解配置优先级及后端限制,比只看到“兼容”就直接迁移全部流量更有用。

    如何理解Univer 1.5.2的二次混淆移除与构建边界?
    如何理解Univer 1.5.2的二次混淆移除与构建边界?

    理解Univer 1.5.2的关键,是把额外混淆与构建压缩分开。本版删除二次混淆插件及相关配置,同时保留Pro模块的minify设置;它解释的是产物处理方式的变化,不代表增加了表格或公式能力。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。

    为什么要购买正版软件?
    01 官方授权

    授权来源透明,订单与许可信息可随时查询。

    02 即时交付

    付款成功后自动发放激活信息,支持订单追踪。

    03 中文协助

    安装、激活、迁移与续费问题都有专人响应。

    04 长期可用

    提供升级提醒与授权管理,换机时也能轻松迁移。

    网站备案号:苏ICP备2026018738号-1 联系邮箱:bd@zhengruan.com 网站地图

    Copyright ©2018-2026