在 BizTalk Server 中启用和查看常见管理操作的审核日志

在 BizTalk Server 2020 及更高版本中,管理员可以在应用程序工件上生成管理操作的审计跟踪。 示例包括发送端口、接收端口、接收位置、业务流程和资源的操作。 还可以对服务实例上的暂停、恢复和终止作业进行审核。

配置审核

默认情况下未配置审核。 要开启审核,请执行以下操作:

  1. 打开 BizTalk Server 管理控制台。

  2. 右键单击 BizTalk 组,然后选择 “设置”。

  3. 选择 审核管理操作

  4. “最大审核条目数 ”框中,输入要保留的条目数。 默认情况下,BizTalk 存储 10,000 个最新条目。

  5. 选择“确定”,保存所做更改。

  6. 如果要在同一会话中执行更多管理作,请刷新管理控制台。

    BizTalk Server 管理控制台中“组”页的屏幕截图。审核管理操作和最大条目框被标出。

查看审核日志

  1. 确认已配置操作数据服务。 该服务应使用属于 BizTalk Server 管理员组BizTalk Server 操作员组BizTalk Server 只读用户组 成员的帐户。

    有关详细信息,请参阅 配置 REST API

  2. 若要查看审核日志,请转到 http://localhost/BizTalkOperationalDataService/AuditLogs

  3. 若要查看特定日期范围内的审核日志条目,请使用以下 URL 格式之一:

    • http://localhost/BizTalkOperationalDataService/AuditLogs?fromDate=<yyyy-MM-dd>&toDate=<yyyy-MM-dd>
    • http://localhost/BizTalkOperationalDataService/AuditLogs?fromDate=<yyyy-MM-dd>T<hh:mm:ss>&toDate=<yyyy-MM-dd>T<hh:mm:ss>

    例如,可以使用以下 URL 之一:

    • http://localhost/BizTalkOperationalDataService/AuditLogs?fromDate=2022-05-01&toDate=2022-05-10
    • http://localhost/BizTalkOperationalDataService/AuditLogs?fromDate=2022-05-01T01:00:00&toDate=2022-05-10T01:00:00

审核日志结构

审核日志包含以下信息:

  • ID:类型 GuidID,每个条目是唯一的。

  • BatchId:在单个 SQL 事务中,你执行的所有审计操作都有相同的 ID。 此值可帮助你将用户操作与低级别的详细信息关联起来。

  • UserPrincipal:执行操作的用户,例如 jeffsmith@Fabricom.com

  • 计算机:运行作的计算机的名称,例如 machine1@contoso.com

  • ArtifactId:项目的唯一 ID。

  • ParentArtifactId:父项目的 ID(如果项目是另一个项目的子项)。

  • ArtifactType:操作所运行的工件类型,例如SendPortReceivePortApplication

  • ArtifactName:项目的名称。 此值由用户配置,例如 FTP send port

  • OperationName:运行在工件上的动作,例如 Create

    下表列出了可以在不同类型的工件上运行的操作:

    工件类型 操作名称
    港口 创建、更新、删除
    服务实例 暂停、恢复、终止
    应用程序资源 添加、更新、删除
    绑定文件 进口
  • 有效负载:有关操作所做更改的信息。 有效负载采用 JSON 格式,例如 {"Description":"New description"}

  • CreatedDate:操作的时间戳。

创建或更新项目时,记录一个或多个审核条目。 例如,创建发送端口时,会为每个系统构件记录审核条目:

  • 发送端口
  • 主要运输
  • 二级运输

这三个条目具有相同的 BatchId。 可以使用 ArtifactIdParentArtifactId 值将主传输和辅助传输的审核日志条目与发送端口相关联。

后续步骤

跟踪和监视 BizTalk Server 的运行状况