日志

原理层

日志的本质

日志是事件（Event）的时间化持久表达。

日志 = 系统在时间维度上，对状态变化、决策行为与异常事实的不可变记录。

其核心在于：

日志在可观测性中的位置

可观测性的三大支柱：

日志解决的是“发生了什么”。

稳定认知

架构层

日志系统的参考抽象模型

事件源（应用）
   ↓
事件记录（Logger）
   ↓
采集与缓冲（Agent / MQ）
   ↓
加工与结构化（Processor）
   ↓
存储（冷热分层）
   ↓
查询与分析（Search / Analytics）

该模型在单体与分布式系统中保持稳定，仅实现方式不同。

单体日志架构

特征：

适用阶段：

分布式日志架构

核心思想：日志写入与业务执行解耦

关键能力：

设计层

日志级别的治理语义

级别 本质含义 组织责任
ERROR 系统或业务进入不可接受状态 必须人工介入
WARN 偏离设计预期但可继续运行 需要评估
INFO 关键状态或行为记录 用于审计与回溯
DEBUG 诊断辅助信息 临时存在
TRACE 细粒度运行细节 高成本、短期

日志级别 = 组织对事件严重性的态度声明。

系统日志 vs 操作日志

类型 本质 受众
系统日志 系统行为与异常 开发 / 运维
操作日志 用户或业务行为 产品 / 审计 / 风控

操作日志必须满足：

日志上下文设计

稳定上下文字段：

没有上下文的日志，几乎不可用。

工程方法层

日志与业务解耦

目标：

日志是对业务事实的“旁观式记录”，而非业务流程的一部分。

性能与成本意识

核心原则：

工程策略：

错误日志的严格使用

ERROR 日志必须满足：

否则应使用 WARN 或 INFO。

选型原则层

日志系统选型维度

维度 关注点
写入模型 吞吐 / 顺序写
查询模型 实时 / 离线
生命周期 冷热分层 / 保留策略
成本 存储 / 计算
治理能力 权限 / 审计 / 合规

组织与文化层

日志的三类受众

日志即制度

关联内容（自动生成）