> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 日誌頁面
> 如何使用知行之橋日誌頁面檢視和處理訊息、交易、SLA、應用程式日誌等。
export const companyName = "知行軟件";
export const siteNameShort = "知行之橋";
export const siteName = "知行之橋";
{siteName} 維護多種型別活動的日誌，包括[訊息](#訊息日誌)、[交易](#交易日誌)、[SLA](#sla-日誌)、[應用程式](#應用程式日誌)和[存取](#存取日誌)請求、[審計](#審計日誌)配置更改以及[個人設定](#個人設定日誌)活動。使用**日誌**頁面檢視和處理你的日誌。每種日誌型別作為單獨的表儲存在應用程式資料庫中。在[日誌](#日誌索引標籤)索引標籤中檢視應用程式、存取、審計和個人設定日誌。
日期/時間項目始終按照瀏覽器的本地時區和日期格式設定進行本地化顯示，因此即使瀏覽到託管在不同時區的伺服器，顯示的時間戳也反映本地時間。
## 搜尋和過濾日誌
每個**日誌**頁面索引標籤的頂部都有一個搜尋欄，你可以使用它來搜尋該頁面上的所有日誌。點選漏斗圖示可開啟上下文相關的過濾器部分，每種日誌型別都有不同的選項。例如，如下圖所示，“訊息”索引標籤具有針對跟蹤訊息頭、時間、端口型別、工作區和狀態的過濾器。
你可以在單個搜尋中同時使用過濾器選項*和*搜尋欄來縮小傳回的結果。下圖顯示了過去 24 小時內狀態為 Success 且訊息文字中包含 `REST` 的訊息。
### 跟蹤訊息頭
{siteNameShort} 支援使用額外的可搜尋中繼資料（跟蹤訊息頭）作為在**訊息**索引標籤中過濾結果的額外方式。你可以透過多種方式新增跟蹤訊息頭：
* **系統設定 > 高階**頁面的**進階設定**部分中的**跟蹤訊息頭**欄位允許你提供以逗號分隔的自定義訊息頭名稱清單。
* 某些端口（如 X12）在**高階**索引標籤中具有設定，可讓你選擇跟蹤某些訊息頭，如 ISA08。
* XML Map 端口允許你右鍵單擊一個元素，並將其作為跟蹤訊息頭新增到輸出訊息。
* ArcScript 中的 `_message` 項允許你透過 `_message.trackedheader:HeaderName` 語法設定跟蹤訊息頭。要檢視使用 `_message` 的其他範例，請閱讀 [知行之橋訊息](../../scripting/introduction-to-arcscript#message-_message)。
{siteNameShort} 在檔案於工作流程中處理時向檔案新增中繼資料訊息頭。將滑鼠懸停在訊息上並點選**檢視詳情**即可找到這些訊息頭。你可以透過以下方式執行此操作：
* 在**訊息**索引標籤中展開訊息
* 開啟**訊息詳情**頁面
* 檢視端口的**交易**索引標籤
## 訊息日誌
**訊息**索引標籤提供訊息透過工作流程的完整過程洞察，其中可能包含許多交易。你可能經常需要檢視收到的訊息發生了什麼，此功能可以讓你看到訊息在工作流程中傳遞時的完整情況。
訊息表包含訊息的完整清單。預設情況下，清單按**最新訊息**列排序，但你可以點選任意列名按該列排序。它顯示以下詳細資訊：
* **最新訊息**——訊息的最新檔名，附帶與此訊息相關的最後一次活動的時間戳。點選此連結可開啟視窗以預覽訊息內容，並可選擇下載、複製或格式化。
* **工作流程開始和最後處理**——訊息來源的[端口 Id](../../connectors)，以及處理與該訊息相關交易的最後一個端口的端口 Id。點選端口 Id 可在[工作流程設計器](../../flows/designing-a-flow)中開啟端口配置頁面。
* **狀態**——訊息的狀態。選項為：
* Success
* Warning
* Error
* Pending
* Skipped
* **總處理時間**——訊息在工作流程中進行處理所花費的時間
搜尋欄和過濾器部分讓你可以根據上面提到的列以及任何跟蹤訊息頭進行過濾。下圖顯示了一個範例過濾器：
要開啟訊息的**訊息工作流程**頁面，請將滑鼠懸停在訊息上，點選最右側出現的箭頭。此頁面顯示工作流程中的所有步驟，以及關聯的文件、其他詳細資訊和日誌。
使用訊息左側的展開器檢視訊息**詳情**，如下所示。
該卡包含：
* 訊息 Id
* 訊息產生的時間
* 與訊息關聯的跟蹤訊息頭清單
* 與訊息關聯的其他訊息頭清單（未跟蹤）
* 與訊息狀態相關的訊息。例如，如果狀態為 *Error*，則卡片會在摘要中顯示導致此狀態的錯誤訊息。
訊息的**日誌**索引標籤列出了與訊息處理相關的日誌。要在 UI 中預覽日誌內容（並可選擇下載檔案），請點選**檔名**列中的連結。
要檢視或下載日誌項目，請點選**日誌**索引標籤。將滑鼠懸停在感興趣的項目上，然後使用下載圖示 
下載單個日誌檔案。或者，使用**下載所有日誌**按鈕下載包含與訊息相關的所有日誌的 zip 檔案。
## 交易日誌
**交易**索引標籤包含所有傳入和傳出檔案傳輸，以及資料轉換端口在本地處理的所有檔案的詳細資訊。例如，AS2 交易日誌包含 HTTP 請求和回應訊息頭、對 AS2 請求的 MDN 回應以及任何通訊錯誤。
交易表為應用程式處理的每個檔案包含一個單獨的行。它顯示以下詳細資訊：
* **日期/時間**——交易的時間戳
* **處理者**——處理交易的端口 Id
* **方向**——交易是*傳送*還是*接收*
* **檔案**——用於開啟已處理檔案的連結
* **狀態**——交易的狀態。成功交易的**狀態**值為 *Success*，而失敗交易報告狀態為 *Error*。
* **大小**——交易檔案的大小
* **處理時間**——處理交易所花費的時間
使用交易左側的展開器檢視更多詳細資訊。這些詳細資訊包括上面描述的相同資訊。唯一區別是，交易日誌只顯示單個交易的資訊，而訊息日誌可能包含許多交易。你也可以使用懸停在交易上時出現的箭頭檢視相同的工作流程頁面。
你還可以在特定端口的**交易**索引標籤中找到交易資訊。
## SLA 日誌
SLA 索引標籤儲存在各個[端口](../../connectors)上配置的每個 SLA 的資訊。它包括 SLA 關聯的[工作區](../../flows/workspaces)資訊，以及狀態資訊和該狀態剩餘的時間。它顯示以下詳細資訊：
* **端口 Id**——每個定義了 SLA 的端口 Id
* **工作區**——關聯工作區的名稱
* **上一個狀態**——先前的 SLA 狀態（例如 *OK*）
* **當前狀態**——當前 SLA 狀態（例如 *At Risk*），以及 SLA 再次更改狀態前的剩餘時間（例如變為 *In Violation*）
## 日誌索引標籤
**日誌**索引標籤包含四組日誌：應用程式、存取、審計和個人設定。預設情況下，每個表都包含今日日誌的摘要計數以及所有日誌的總計數。應用程式日誌還會將相似項目歸入模式。點選每個部分中的**檢視全部**連結，可在視窗中填充該類別的完整日誌清單。在這裡，你可以像處理其他日誌型別一樣搜尋、過濾和下載日誌。
### 應用程式日誌
應用程式日誌記錄處理過程中發生的任何應用程式級錯誤以及對應用程式資源發出的任何請求。這裡的錯誤訊息有助於為特定交易的錯誤提供上下文。
使用此索引標籤驗證外部貿易伙伴的 Web 請求是否已成功路由到 {siteNameShort} 工作流程中的端口。當應用程式在公共端點接收到 Web 請求時，它會嘗試根據訊息頭（例如 AS2 識別碼）將訊息路由到特定端口。如果某個錯誤阻止應用程式成功路由訊息，則此錯誤會顯示在**應用程式**索引標籤上。
為了讓你快速發現重複出現的問題和高頻活動，{siteNameShort} 會將相似的應用程式日誌項目歸入\_模式\_，如下圖所示。模式表示一組結構相同的訊息，其中每條訊息的可變部分（例如 ID、計數和任務名稱）會替換為 `<*>` 萬用字元。例如，訊息 `Stopped task [CheckIntegrityTask]` 和 `Stopped task [PortHealthCheckTask]` 都會歸入模式 `Stopped task <*>`。
預設情況下，**日誌**索引標籤上的**應用程式日誌**卡片顯示這種精簡的模式檢視。卡片頂部的**錯誤**和**警告**磁貼顯示各級別的當前計數。磁貼下方的表格列出檢測到的每個模式，每一行顯示以下詳細資訊：
* **計數**——匹配該模式的日誌項目數
* **趨勢（時間段）**——顯示該模式隨時間出現頻率的迷你趨勢圖
* **級別**——模式的日誌級別（例如 *Info*）
* **模式範本**——共享的訊息結構，其中可變值顯示為 `<*>`
* **首次出現**——匹配該模式的最早項目的時間戳
卡片底部顯示今天記錄的日誌數以及日誌總數。
要檢視模式組的更多詳細資訊，請點選**檢視全部**。完整日誌視窗預設在**模式**檢視中開啟；將滑鼠懸停在表格中的任意行上並點選**檢視詳細資訊**，可檢視構成該模式的日誌詳情。要檢視單個日誌項目而不是分組模式，請點選工具列中的**日誌**按鈕。
在**日誌**檢視中，應用程式表為每個應用程式事件包含一個單獨的行。它顯示以下詳細資訊：
* **日期/時間**——事件的時間戳
* **級別**——日誌級別。檢視**訊息**列中的資訊以瞭解詳細資訊。選項為：
* None——不記錄事件
* Error——處理過程中遇到的錯誤資訊
* Warning——處理過程中遇到的警告資訊
* Info——有關處理的一般資訊，包括任何錯誤和警告（如果適用）
* Debug——成功和失敗流程的詳細偵錯資訊
* Trace——成功和失敗流程的詳細跟蹤資訊（如果需要將日誌傳送給 {companyName} 支援，此級別很有用）
你可以在**系統設定 > 高階**頁面的**進階設定**部分更改日誌級別。但是，提高日誌詳細程度可能會影響資料庫效能，尤其是對於 SQLite 或 H2 等效能較低的資料庫型別。僅在有特定原因時才調整日誌級別。
日誌記錄級別 **Debug** 和 **Trace** 可能會記錄敏感資訊，包括檔案資訊和 SSL 憑證。儘管密碼等敏感詳細資訊會被遮蔽，但在將這些日誌共享到組織外部之前，你應檢查其中是否包含敏感資訊。
* **資源**——生成訊息的資源
* **訊息**——訊息文字
* **例項 Id**——事件發生的機器
### 存取日誌
存取日誌記錄對應用程式提供的端點發出的請求項目。這包括 API 請求、公開公共端點的端口（例如 Webhook），以及與接收資料相關的公共端點（例如 public.rst）。它顯示以下詳細資訊：
* **日期/時間**——交易的時間戳
* **方法**——使用的 HTTP 方法
* **URL**——URL
* **使用者**——發出請求的已認證使用者。如果發出請求的使用者是匿名使用者，則此項目為空。
* **使用者型別**——使用者是**標準**使用者（人工）還是**服務**使用者（自動化的機器到機器存取）。有關更多資訊，請參閱[使用者型別](./settings/users#使用者型別)。
* **遠端 IP**——發出請求的 IP 地址
* **例項 Id**——為請求提供服務的例項 Id
### 審計日誌
審計日誌儲存對應用程式配置所做的每個更改。這包括建立端口、配置端口、更新個人設定等所有操作。它顯示以下詳細資訊：
* **日期/時間**——配置更改的時間戳
* **操作**——所做更改的型別。選項為：
* GET
* POST
* PUT
* MERGE
* PATCH
* **資源**——管理控制檯（作為管理和配置應用程式的典型介面的 Web UI）或[系統 API](../../admin-api)（可用於管理和配置應用程式的基於 REST 的 API）。
* **訊息**——描述更改的文字
* **使用者**——進行更改的使用者
* **使用者型別**——使用者是**標準**使用者（人工）還是**服務**使用者（自動化的機器到機器存取）。有關更多資訊，請參閱[使用者型別](./settings/users#使用者型別)。
你可以查詢審計日誌以執行應用程式配置審計。
### 個人設定日誌
個人設定日誌記錄已配置通訊[個人設定](./profiles)中的活動。這包括檔案傳輸、協議級事件，以及 AS2、AS4 和 SFTP Server 等個人設定的伺服器活動。它顯示以下詳細資訊：
* **日期/時間**——活動的時間戳
* **端口**——涉及的端口 Id
* **檔案**——用於開啟個人設定日誌檔案的連結
* **狀態**——操作的狀態。選項為 Complete、In Progress
## 防篡改日誌
{siteNameShort} 對所有[審計日誌](#審計日誌)都包含加密防篡改日誌記錄。這確保了在日誌資料被更改或篡改時，能夠及時向使用者發出警示。它透過以加密方式將日誌項目連結成鏈，建立不可變的系統活動審計跟蹤，從而使未經授權的修改能夠被立即檢測到。每個日誌項目都包含其自身內容以及前一個項目雜湊值的加密雜湊，從而形成一個可驗證的鏈條，對歷史記錄的任何改動都會破壞鏈條的完整性。這種方法有助於組織滿足 HIPAA 和 GDPR 等監管要求。
完整性檢查作為應用程式健康檢查的一部分每小時執行一次。如果檢測到篡改，系統將記錄錯誤。如果在[通知](./settings/alerts)索引標籤上配置了電子郵件警示，系統將向管理員傳送電子郵件。
管理員可以使用 [integrityResetTampering](../../scripting/operations/op-integrity-reset-tampering) 操作來重置雜湊鏈並清除篡改警告。
## 偵錯日誌
某些端口在**高階**配置索引標籤中具有設定，用於增強交易日誌的詳細程度。這些詳細日誌在偵錯時很有用，並且在向 *[edi@kasoftware.cn](mailto:edi@kasoftware.cn)* 請求支援時通常是必需的。
最常見的高階配置設定是**日誌級別**。當設定為 *Debug* 時，處理交易時已生成的交易日誌中會新增附加資訊。
一些傳送出站請求的端口還具有**記錄請求**設定。當設定為 *True* 時，交易日誌將包含傳送到遠端伺服器的請求副本。這有助於縮小接收伺服器回應時出現問題的範圍。
一些針對遠端系統發出查詢的端口具有**詳細程度**和/或**日誌檔案**設定。**詳細程度**應設定在 1 到 5 之間（其中 5 最詳細，並且在大多數情況下建議使用）。當**日誌檔案**是可用設定時，請將其設定為磁碟上的路徑以寫入專用日誌檔案；你可以將此檔案與處理交易時生成的交易日誌一起提供給支援人員。