1小时搭建日志分析原型：Loguru+FastAPI实战

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

   用FastAPI和Loguru快速开发一个带完整日志系统的REST API原型。功能要求：1. 自动记录每个请求的入参和响应 2. 错误请求详细上下文记录 3. 按日期分割日志文件 4. 提供/logs接口查看最近错误。输出可立即运行的完整项目代码。

3. 点击'项目生成'按钮，等待项目生成完整后预览效果

在项目初期快速验证想法时，一个具备完善日志系统的API原型能极大提升开发效率。最近我用FastAPI和Loguru在InsCode(快马)平台上实践了这个组合，1小时就完成了带完整日志功能的REST API原型搭建，下面分享具体实现思路和关键步骤。

为什么选择这个技术栈

1. FastAPI的天然优势：作为现代Python框架，其自动生成的交互文档和类型提示特别适合快速原型开发。请求验证、序列化等繁琐工作都能自动处理，让我们专注核心逻辑。
2. Loguru的零配置日志：相比标准logging模块，它提供开箱即用的彩色输出、文件轮转和结构化日志，用几行代码就能实现复杂功能。
3. 组合效能：两者都强调开发者体验，配合使用时能形成"开发-调试-监控"的闭环。

核心功能实现要点

1. 请求全链路日志：通过FastAPI中间件捕获请求到达和响应返回两个时间点，记录包括URL、方法、客户端IP、耗时等关键信息。特别注意过滤敏感字段如密码等。
2. 错误上下文记录：重写HTTP异常处理器，在捕获到4xx/5xx错误时，自动记录当时的请求参数、headers和堆栈信息到独立错误日志文件。
3. 日志文件管理：配置Loguru按日期自动分割文件，保留最近7天日志。区分访问日志和错误日志两种类型，分别存储在不同目录。
4. 日志查看接口：开发/logs端点，通过读取日志文件返回最近错误信息。考虑到性能，实现分页和关键词过滤功能。

开发中的实用技巧

1. 结构化日志格式：采用JSON格式存储日志，方便后续用ELK等工具分析。关键字段包括timestamp、level、request_id、path等。
2. 请求ID贯穿：为每个请求生成唯一ID，在日志、响应头中都携带该ID，便于问题追踪时串联上下游日志。
3. 敏感信息脱敏：在日志中间件中添加过滤规则，对Authorization、password等字段进行掩码处理。
4. 性能考量：文件写入采用异步方式，避免阻塞主线程。对于高频访问的/logs接口，添加内存缓存减少IO操作。

典型问题解决方案

1. 日志文件权限：部署时注意设置日志目录的写入权限，特别是在Docker环境中要处理好volume映射。
2. 时区统一：确保所有日志使用UTC时间并记录时区信息，避免多服务器协同时的时序混乱。
3. 日志轮转失效：测试大日志文件场景，验证是否按预期分割。必要时调整retention参数控制磁盘占用。
4. 中间件顺序：认证中间件需放在日志中间件之前，确保能记录到用户身份信息。

在InsCode(快马)平台实践时，发现其内置的Python环境已经预装好所有依赖，省去了环境配置时间。完成编码后，直接用平台的一键部署功能就将这个API服务发布到了线上，整个过程非常流畅。

这个原型现在每天自动记录约5000条请求日志，帮团队快速发现了三个接口性能瓶颈。后续计划加入日志报警功能，当错误率超过阈值时自动通知开发者。这种快速验证的方式，特别适合在需求不确定的早期阶段使用。

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

   用FastAPI和Loguru快速开发一个带完整日志系统的REST API原型。功能要求：1. 自动记录每个请求的入参和响应 2. 错误请求详细上下文记录 3. 按日期分割日志文件 4. 提供/logs接口查看最近错误。输出可立即运行的完整项目代码。

3. 点击'项目生成'按钮，等待项目生成完整后预览效果