---
pkg: '@nocobase/plugin-logger'
title: "日志与审计概览"
description: "NocoBase 日志体系：服务端日志（系统运行、请求）、审计日志（用户操作、资源变更）、历史记录（数据变更前后值、版本对比）。"
keywords: "服务端日志,审计日志,历史记录,请求日志,用户操作审计,数据变更历史,NocoBase"
---

# 服务端日志、审计日志、历史记录

## 服务端日志

### 系统运行日志

> 参考 [系统日志](./index.md#系统日志)

- 记录应用系统的运行信息，跟踪代码逻辑的执行链路，追溯代码运行错误等异常信息。
- 存在日志分级，按功能模块分类。
- 通过终端输出或以文件形式存储。
- 主要是用来排查系统运行期间出现的异常情况。

### 请求日志

> 参考 [请求日志](./index.md#请求日志)

- 记录 HTTP API 请求和响应信息，侧重点在记录请求 ID, API Path, 请求头，响应状态码，耗时等信息。
- 通过终端输出或以文件形式存储。
- 主要是用来跟踪 API 的调用和执行情况。

## 审计日志

> 参考 [审计日志](/security/audit-logger/index.md)

- 记录用户 (API) 的对系统资源的操作行为，侧重点在记录资源类型、资源对象、操作类型、用户信息、操作状态等。
- 为了更好地追踪用户操作的具体内容和结果，请求参数和请求响应会作为 MetaData 信息记录下来。这部分信息和请求日志有一部分重叠，但不是完全一致，例如在现有请求日志中通常也不会记录完整的请求体。
- 请求参数和请求响应不等同于资源的快照，可以通过参数和代码逻辑知道操作产生了什么样的修改，但无法准确知道数据表记录修改前是什么内容，实现版本控制和误操作之后的数据恢复。
- 以文件和数据表形式存储

![](https://static-docs.nocobase.com/202501031627922.png)

## 历史记录

> 参考 [历史记录](/record-history/index.md)

- 记录数据内容的变更历史。
- 主要记录的内容为资源类型、资源对象、操作类型、变更字段、变更前后值。
- 可用于数据对比。
- 以数据表形式存储。

![](https://static-docs.nocobase.com/202511011338499.png)
