線上與離線稽核資料 (直接持續性)
「直接持續性」實行中的服務及其參數與「資料表」實行中的服務及其參數不同。本主題說明線上與離線稽核資料、您可以用來擷取資料的服務,以及直接持續性實行中使用的參數。
線上稽核資料
當直接持續性實行處於使用中狀態時,會根據針對稽核子系統 DaysOnline 參數指定的值,將線上稽核項目保留在線上。我們提供了一些服務,用來管理線上稽核資料存放區中的資料量:
封存與清除操作由 ThingWorx Platform 中的相關排程器物件觸發。這些排程器物件負責定期呼叫這些服務。您可配置排程器,以符合您組織的需求。依預設,這些服務會每天執行一次。您也可以在需要時手動呼叫。線上稽核訊息會持續保留在檔案中,這些檔案儲存在稽核子系統 AuditArchiveFileRepositoryAuditArchiveDirectPersistence 目錄中。您無法配置此存放庫。
* 
在稽核子系統的前後關聯中,離線是指無法再篩選或搜尋稽核訊息,稽核訊息也不再儲存於線上資料庫中。
線上稽核資料的保留條件是稽核子系統的「要將稽核資料保留在線上的天數」組態參數。ArchiveAuditHistoryDirectPersistence 服務不會刪除符合此保留條件的資料;而是如果符合條件,可以根據排程或手動執行單獨的 PurgeAuditData 服務來刪除線上稽核資料。
欲使用 QueryAuditHistoryWithQueryCriteria 服務搜尋線上稽核資料,請參閱
離線稽核資料
離線稽核資料提供一個儲存位置,可供您儲存不需要經常存取,但出於管理目的想要保留的稽核資料。ArchiveAuditHistoryDirectPersistence 服務會將線上稽核資料複製到離線儲存區。下列服務可讓管理員管理離線資料:
ExportAuditData 服務會呼叫 ArchiveAuditHistoryDirectPersistence 服務,其會將請求的線上稽核資料從 AuditArchiveFileRepository 複製到指定的匯出檔案。匯出操作會處理並翻譯該已封存資料,並將其儲存在指定的匯出檔案中。
CleanUpOfflineAudit 服務通常會根據排程器執行。您也可以手動執行此服務。您可以將 olderThanDate 傳遞給服務,來指定要從 AuditArchiveFileRepository 中刪除的已封存檔案。
離線檔案封存時不會進行當地語系化。根據指定的地區設定,可以使用離線讀取器服務 ExportAuditData 擷取這些檔案。如需詳細資訊,請參閱匯出稽核資料
下列圖表顯示了離線封存檔案的階層。圖表之後段落的內容說明了 FileRepository 正下方的節點「使用中實行的 OfflineAudit 資料夾」。
離線封存的階層
在上面的圖表中,「使用中實行的 OfflineAudit 資料夾」節點表示使用中實行 (直接持續性與/或資料表) 存放庫中的主目錄。如果您從資料表實行開始,並於稍後轉換為直接持續性實行,則此處會有兩個目錄:AuditArchive (針對資料表實行) 與 AuditArchiveDirectPersistence (針對直接持續性實行)。這兩個目錄都有如上所示的相同子目錄結構。當您從一個實行轉換為另一個實行時,會保留已封存的稽核資料。
* 
如果您決定從一個實行轉換為另一個實行,請先確定您已封存需要保留的任何稽核資料,然後再進行轉換。
有日期的資料夾適用於它們所包含之稽核訊息的日期,而不是執行封存的日期。如上圖所示,有日期的資料夾名稱的格式為 YYYY-MM-DD (ISO 8601) 格式,且每天的稽核訊息都有一個新資料夾。「離線稽核內容塊」位於包含該日期之稽核訊息的壓縮 JSON 檔案中。預設內容塊大小為 50,000 列。請注意,大小下限為 10,000 列。系統管理員可以在稽核子系統的組態中變更內容塊的預設大小。例如,系統管理員可以指定 70,000 列的內容塊大小。壓縮的內容塊檔案就會以那麼多的訊息列存在於有日期的資料夾中。如果每個稽核項目為 ~1KB,那麼未壓縮或在記憶體中的內容塊檔案大小則為 ~70MB。
資料保留與效能
為了使效能達到最佳,線上稽核資料與離線資料儲存區之間必須保持平衡。稽核子系統提供封存與清除操作,可協助您使系統達到最佳平衡狀態。雖然封存操作不會檢查子系統的 DaysOnline 參數,但 PurgeAuditData 服務會進行檢查。
當其排程器呼叫 ArchiveAuditHistoryDirectPersistence 服務時,會將目前日期傳遞為 olderThanDate。早於此日期的所有線上稽核訊息都會封存。此服務不會檢查稽核子系統的 DaysOnline 參數。
PurgeAuditData 服務會檢查稽核子系統 DaysOnline 參數的值,以決定應清除哪些線上稽核訊息,以及應使哪些訊息保持線上可用。在刪除稽核訊息之前,此服務會檢查是否有標記為刪除任何線上稽核訊息尚未封存。如果有,此服務會呼叫 ArchiveAuditHistoryDirectPersistence 服務。這些動作可確保在刪除之前先封存要刪除的任何資料。
* 
如果 DaysOnline 的值為 0,且呼叫了清除服務,則會將所有資料移至離線存放庫,然後再將其從線上存放庫刪除。
匯出線上與離線稽核資料
從 ThingWorx Platform v.9.0.0 開始,稽核子系統有兩個匯出服務,一個僅用於線上稽核資料,另一個用於線上與離線稽核資料。如需有關使用這些服務匯出稽核資料的資訊,請參閱 匯出線上稽核資料匯出稽核資料
這是否有幫助?