在 BizTalk Server 中啟用和檢視常見管理作業的稽核記錄

發行項
10/14/2023

在 BizTalk Server 2020 和更新版本中，系統管理員可以在應用程式成品上產生管理作業的稽核線索。範例包括傳送埠、接收埠、接收位置、協調流程和資源上的作業。您也可以稽核服務實例上的暫停、繼續和終止作業。

設定稽核

預設不會設定稽核。開啟稽核：

開啟 BizTalk Server 管理主控台。
以滑鼠右鍵按一下 [BizTalk 群組]，然後選取 [ 設定]。
選取 [稽核管理作業]。
在 [ 稽核專案數目上限 ] 方塊中，輸入您想要保留的專案數目。根據預設，BizTalk 會儲存 10,000 個最新的專案。
選取 [ 確定 ] 以儲存變更。
如果您想要在同一個會話中執行更多管理作業，請重新整理管理主控台。

檢視稽核記錄

確認已設定 Operational Data Service 。服務應該使用屬於BizTalk Server系統管理員、BizTalk Server操作員或BizTalk Server唯讀使用者群組成員的帳戶。

如需詳細資訊，請參閱設定 REST API。
若要檢視稽核記錄，請移至 http://localhost/BizTalkOperationalDataService/AuditLogs 。
若要查看特定日期範圍的稽核記錄專案，請使用下列其中一種格式作為 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

稽核記錄結構

稽核記錄包含下列資訊：

識別碼：類型 Guid 為的識別碼，每個專案都是唯一的。
BatchId：您在單一 SQL 交易中執行之所有稽核作業的識別碼相同。此值可協助您將使用者作業與較低層級的詳細資料相互關聯。
UserPrincipal：執行作業的使用者，例如 jeffsmith@Fabricom.com 。
電腦：作業執行的電腦名稱稱，例如 machine1@contoso.com 。
ArtifactId：成品的唯一識別碼。
ParentArtifactId：如果成品是另一個成品的子項，則父成品的識別碼。
ArtifactType：作業在上執行的成品類型，例如 SendPort 、 ReceivePort 或 Application 。
ArtifactName：成品的名稱。這個值是由使用者設定，例如 FTP send port 。
OperationName：在成品上執行的動作，例如 Create 。

下表列出您可以在不同類型的成品上執行的作業：

成品類型作業名稱

連接埠建立、更新、刪除

服務執行個體暫止、繼續、終止

應用程式資源新增、更新、移除

系結檔案匯入
承載：作業所做的變更相關資訊。承載是 JSON 格式，例如 {"Description":"New description"} 。
CreatedDate：作業的時間戳記。

建立或更新成品時，會記錄一或多個稽核專案。例如，建立傳送埠時，會記錄每個成品的稽核專案：

傳送埠
主要傳輸
次要傳輸

這三個專案都有相同的 BatchId。您可以使用 ArtifactId 和 ParentArtifactId 值，將主要和次要傳輸的稽核記錄專案與傳送埠相互關聯。

下一步

追蹤並監視您BizTalk Server的健康情況。