跳转到主要内容
审计日志是按公司保存的历史记录,记载 Alforse 主要业务记录的创建、更新和删除,以及每次更改的操作人和涉及的字段。管理员开启后,任何有权查看设置的人都可以直接回答“这是谁、什么时候改的?”,无需到处询问。

审计日志的工作原理

日志记录默认关闭,并按公司分别保存。开启后,Alforse 会记录之后对受审计实体的每次更改。开启之前或关闭期间所做的更改不会被记录。 条目按人们操作的业务实体分组,而不是按发生变化的数据库行。例如,编辑物料的成本会产生一条物料条目,而不是底层 itemCost 行的条目。

条目包含的内容

差异中不包含 updatedAt、updatedBy 和内部嵌入向量等维护性字段,因此条目只显示人们关心的更改。

受审计的实体

只有下表中的实体会被审计。无论日志是否开启,对其他对象的更改都不会被记录。

开启和关闭日志记录

设置 → 审计日志下的审计日志卡片只有一个开关。 关闭开关会停止产生新条目,但保留现有历史。重新开启后从那一刻起继续记录;关闭期间的空档保持为空。

查看更改

同一份数据可在两个范围内查看。

单条记录的历史

在大多数详情页(如客户、销售订单、工单或发运单)上,历史记录操作会打开一个抽屉,显示该记录的时间线。每次更改显示操作、操作人、时间,以及可展开的已更改字段列表。 如果日志记录已关闭,抽屉会显示 “Audit logging is not enabled”(未启用审计日志)。能够更新设置的用户可使用快捷方式启用;其他人会被告知联系管理员。

全公司日志

在设置 → 审计日志中,选择查看全部可打开全屏的所有审计日志表格。它支持搜索和分页,列为实体、操作、更改者、更改和何时。 操作以彩色徽章显示:已创建为绿色,已更新为蓝色,已删除为红色。展开一行可查看其字段级差异,选择实体值可打开它所指向的记录。

保留期与归档

实时日志保留 30 天的条目。每晚有一个任务会把更早的条目移入压缩归档,记录归档的日期范围、行数和大小,并从实时表中删除这些条目。 归档列在设置页面的已归档日志下。下载会为压缩导出文件创建一个短期有效的签名链接,因此每次都请重新获取链接,不要保存旧链接。在第一个归档生成之前,该卡片会说明超过 30 天的日志将归档到此处。

权限与套餐

关于设置模块如何对应员工类型,参见权限与访问。

故障排除

”Upgrade to Business to enable audit logging”(升级到 Business 以启用审计日志)

原因: 公司未使用 Business 套餐,因此设置 → 审计日志中的开关被锁定。 处理: 升级套餐,然后开启日志记录。

“Upgrade to unlock audit history”(升级以解锁审计历史)

原因: 同样的套餐限制,显示在记录的历史记录抽屉中。 处理: 升级到 Business 套餐;该限制同时涵盖设置开关和抽屉。

“Audit logging is not enabled”(未启用审计日志)

原因: 已打开历史记录抽屉,但公司关闭了日志记录。 处理: 拥有更新设置权限的用户在设置 → 审计日志中将其开启。如果你没有该权限,请联系管理员。

“Failed to enable audit logging” 或 “Failed to disable audit logging”(启用或禁用审计日志失败)

原因: 创建或移除公司日志存储及变更订阅时发生服务器错误。 处理: 重试。如果持续失败,可能是日志表或其订阅状态不一致;再切换一次开关即可重新同步。

“Failed to generate download URL”(生成下载链接失败)

原因: Alforse 无法创建签名链接,可能是归档的已存储文件缺失,或签名请求失败。 处理: 重试。链接很快失效,旧链接将无法使用。

某条记录没有历史

请检查三点。更改发生时日志记录必须已开启,因为 Alforse 不会回填。该记录的实体必须出现在受审计的实体中。只涉及维护性字段(updatedAt、updatedBy、嵌入向量)的更改不会显示字段级差异。

表格中缺少较早的更改

实时日志只保留最近 30 天。较早的更改请到已归档日志下可下载的导出文件中查找。

相关内容