审计追踪 (`OrchardCore.AuditTrail`)¶

审计追踪模块提供了系统中某些更改和事件的不可变（对于用户，甚至管理员，但对于开发人员不是）可审计日志。这包括例如创建或删除内容项以及用户登录失败等事件。对于内容项，可以恢复以前的版本和已删除的项，并可以跟踪更改。

一般概念¶

如果系统中发生了某个支持的事件，则会创建审计追踪事件。虽然有几个内置事件处理程序用于最重要的事件，但这是可扩展的，模块作者可以提供自己的事件处理程序。

启用模块后，您将在管理UI中看到一个名为 Audit Trail 的新菜单项。列表显示了记录的审计追踪事件。

使用审计追踪事件列表¶

审计追踪事件列表提供了过滤和分页功能，以便轻松查找您要查找的审计追踪事件。默认情况下，您可以按以下标准进行过滤：

-给定的日期范围， -类别（例如所有类别，内容，用户）。

此外，您可以按各种参数对条目进行排序。

事件提供其行的各种详细信息：

-事件的类别和类型（例如内容和已发布）。 -记录事件的时间。 -启动事件的用户。 -如果有的话，事件特定的快速摘要。例如，内容类别的事件会向您显示内容项的版本和标题。如果单击版本X链接，则可以查看填充有该版本的内容项的值的只读编辑器。如果单击内容项的显示文本，则可以编辑内容项的最新版本。 -事件特定的按钮（如果有）。例如，内容类别的事件将显示一个查看按钮，您可以使用该按钮查看给定版本的内容项，以及一个还原按钮，您可以使用该按钮将内容项还原到版本，即使该项已被删除（恢复的项将被创建为草稿版本，然后您需要发布）。 -一个详细信息链接。在这里，您可以获取有关给定事件的更多一般信息，以及事件处理程序可以提供自定义信息。例如，如果您查看内容事件的详细信息视图，则还可以在差异选项卡下查看当前版本的内容项与上一个版本之间的文本差异。当前版本的值将显示为绿色，上一个版本的值将显示为红色。

审计追踪设置¶

如果导航到配置->设置->审计追踪，则会看到各种配置选项，具体取决于启用的审计追踪功能：

-包含您可以使用审计追踪模块记录的每个事件的列表。在此处，您可以启用或禁用记录给定事件。 -您可以启用客户端IP地址记录。启用此功能后，将在审计追踪事件中记录客户端IP地址。请注意，根据您的站点所在的立法，您需要特别注意收集和存储此类个人可识别信息。 - 修剪设置是关于配置您希望在数据库中保留审计追踪事件的时间长度。如果您希望无限期保留事件，则可以禁用修剪。 -可以添加其他选项卡。例如，内容选项卡允许您选择要为其记录审计追踪事件的哪些内容类型。

审计追踪部分¶

您可以将AuditTrailPart内容部分附加到内容类型。这将允许内容编辑器在保存内容项时输入要保存到审计追踪事件中的注释。然后，这将在审计追踪事件列表中可见。

记录自定义事件¶

Orchard Core是可扩展的，审计追踪模块也不例外。因此，在创建自己的模块时，您也可以使用审计追踪记录事件。查看OrchardCore.Users或OrchardCore.Contents模块的源代码以获取示例。

视频¶

CREDITS¶

jsdiff¶

该文档由ChatGPT 4 翻译

Last update: March 22, 2023

审计追踪 (OrchardCore.AuditTrail)¶