在 BizTalk Server 2020 和更新版本中,系統管理員可以在應用程式成品上產生管理作業的稽核線索。 範例包括傳送埠、接收埠、接收位置、協調流程和資源上的作業。 您也可以對服務實例進行暫停、繼續和終止的稽核作業。
設定稽核
預設不會設定稽核。 若要開啟稽核:
開啟 BizTalk Server 管理控制台。
以滑鼠右鍵按兩下 [BizTalk 群組],然後選取 [ 設定]。
選取 [稽核管理作業]。
在 [ 稽核項目數目上限 ] 方塊中,輸入您想要保留的項目數。 根據預設,BizTalk 會儲存 10,000 筆最新的記錄。
選取 [確定] 以儲存您的變更。
如果您想要在同一個會話中執行更多管理作業,請重新整理管理主控台。
檢視稽核記錄
確認 作業數據服務 已設定。 服務應該使用屬於 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 交易中,所有稽核作業共用的 ID。 此值可協助您將用戶作業與較低層級的詳細數據相互關聯。
UserPrincipal:執行作業的使用者,
jeffsmith@Fabricom.com
例如 。機器:作業執行的電腦名稱,例如
machine1@contoso.com
。ArtifactId:成品的唯一標識符。
ParentArtifactId:如果該文物是另一個文物的子系,則此為父文物的識別碼。
ArtifactType:作業執行的成品類型,例如
SendPort
、ReceivePort
或Application
。ArtifactName:成品的名稱。 這個值是由使用者所設定,例如
FTP send port
。OperationName:在成品上執行的動作,例如
Create
。下表列出您可以在不同類型的成品上執行的作業:
成品類型 作業名稱 港口 建立、更新、刪除 服務執行個體 暫停、繼續、終止 應用程式資源 新增、更新、移除 綁定檔案 進口 Payload:有關操作變更的資訊。 承載格式為 JSON 格式,例如
{"Description":"New description"}
。CreatedDate:作業的時間戳。
建立或更新工件時,會記錄一或多筆稽核記錄。 例如,建立傳送埠時,會記錄每個項目的稽核記錄:
- 傳送埠
- 主要交通
- 次要傳輸
這三個條目都有相同的 BatchId。 您可以使用 ArtifactId 和 ParentArtifactId 值,將主要和次要傳輸的稽核記錄專案與傳送埠相互關聯。