8、日志记录与聚合的全面指南

日志记录与聚合的全面指南

1. 日志记录的基础

1.1 日志级别

在确定记录哪些内容之前，需要了解不同的日志级别。常见的日志级别有 DEBUG、INFO、WARN、ERROR 和 FATAL，每个级别包含特定类型的信息：
| 日志级别 | 描述 | 示例 |
| ---- | ---- | ---- |
| DEBUG | 与程序中正在进行的操作相关的任何信息，通常由程序员为调试目的编写 | 函数调用参数、变量值等 |
| INFO | 用户发起的操作或系统操作，如计划任务执行、系统启动和关闭 | 用户登录、定时任务开始 |
| WARN | 未来可能变成错误状态的任何情况 | 库弃用警告、可用资源不足、性能缓慢 |
| ERROR | 所有错误情况 | 数据库连接失败、文件读取错误 |
| FATAL | 导致系统关闭的错误情况 | 系统启动时内存不足 |

这些级别定义无法通过编程强制执行，需要工程师在适当的级别记录日志。因为人们在搜索信息时会解析日志，如果错误消息记录在错误的级别，会增加查找的难度。

1.2 好的日志消息的关键

好的日志消息的关键在于上下文。每条日志消息都应从这样的角度编写：它是某人在查看所记录内容时唯一能看到的消息。例如，“Transaction complete” 这样的消息是无用的，因为它可能依赖于之前的消息，并且事务的细节需要从之前的日志消息中推断。

日志消息应采用结构化字段格式，例如处理订单时的日志文件结构：

{
    "timesta