审计日志的工作原理
日志记录默认关闭,并按公司分别保存。开启后,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、嵌入向量)的更改不会显示字段级差异。