使用日誌和追蹤檔案進行疑難排解

本節說明如何使用日誌及追蹤檔來進行疑難排解。 其中包含下列主題:

"日誌和追蹤檔案的概觀"

配置日誌訊息的電子郵件通知

"配置記載與追蹤"

在日誌檢視器中使用追蹤

日誌和追蹤檔案的概觀

記載是用來傳達系統訊息、元件狀態變更、失敗及追蹤資訊。 從 InterChange Server Express、協同作業物件及連接器產生的訊息會傳送至您在安裝 InterChange Server Express 時所指定的目標,預設為 STDOUT (標準輸出)。由連接器代理程式產生的訊息會傳送至 STDOUT, 但也可以將其配置為傳送至代理程式位置的個別日誌檔。

註:
OS/400 上的 STDOUT 導致資訊寫入至與 InterChange Server Express 工作相關聯的排存檔。因此,在 OS/400 上,記載作業會依預設配置為傳送至 /QIBM/UserData/WBIServer43/serverName/log 目錄中的檔案,其中 serverName 是 InterChange Server Express 實例的名稱 (預設伺服器名稱是 QWBIDFT)。

傳訊系統永遠都是作用中,並提供精確的系統監視器。

註:
若您將從連接器代理程式產生的訊息配置成要傳送到個別的日誌檔, 您所指定的日誌檔或位置必須是 InterChange Server Express 日誌檔不同。

您除了可以將傳訊系統配置為將訊息傳送至標準輸出之外,也可以傳送至日誌檔或電子郵件收件人。 您可以配置日誌檔的備份檔 (保存檔),並決定檔案的大小。 在發生問題且需要詳細資訊以進行疑難排解時,可以配置追蹤 (預設為停用,因為它會影響系統資源)。

有兩種工具提供圖形使用者介面,供配置及檢視訊息日誌及追蹤:

註:
「日誌檢視器」只在 Windows 2000 或 Windows XP 作業系統上執行。若要使用「日誌檢視器」配置或檢視 Linux 或 OS/400 日誌檔或訊息, 請將檔案複製至已安裝 IBM WebSphere InterChange Sever Express 產品的 Windows 機器, 或將網路磁碟機從 PC 對映至 OS/400 系統,然後直接從對映的磁碟機存取日誌檔。
註:
在 OS/400 上,判定日誌檔和追蹤檔中的時間戳記,是根據 2 個系統值 (QTIME 及 QUTCOFFSET) 設定, 以及 SystemDefault.properties 檔案 (位於 /QIBM/UserData/Java400/ 目錄) 中的 user.timezone 內容設定。當 user.timezone 設為一值時,例如, user.timezone=EDT,OS/400 上的 Java 將以「東區日光節約時間」來產生時間戳記。 如果未設定 user.timezone,OS/400 上的 Java 將採用 QTIME 並從中扣除 QUTCOFFSET 的值, 以「格林威治標準時間 (GMT)」產生時間戳記。因此,比方說,如果 QUTCOFFSET 是 -04:00 (東部時區),則 Java 將從 QTIME 的現行值扣除 -4,以取得 GMT。 在 OS/400 版本 5R3 上,不要設定 QUTCOFFSET,您應設定系統值 QTIMZON。 如需詳細資訊,請參閱 OS/400 上系統值的說明文字。

除了使用「日誌檢視器」來檢視日誌之外, 您還可以使用文字編輯器來開啟日誌,或建立您自己的工具來過濾日誌檔。

如需使用「日誌檢視器」來檢視記載及追蹤訊息的相關資訊,請參閱日誌檢視器及追蹤的概觀

本節包含下列主題:

"協同作業物件訊息"

"連接器訊息"

"訊息格式"

"系統日誌"

"記載/追蹤檔案管理"

協同作業物件訊息

協同作業物件可以產生訊息以報告執行時期資訊、警告與錯誤。例如,協同作業可以記載其決策點及作業的結果。

當 InterChange Server Express 執行協同作業物件時,它會將其訊息寫入日誌中。 如需配置系統記載的相關資訊,請參閱"配置記載與追蹤"

此外,您可以將協同作業物件的訊息以電子郵件傳送給一個或多個收件人。 您可以為每一個協同作業物件指定不同組的電子郵件收件人。 如需使用電子郵件通知的規則資訊,請參閱"配置日誌訊息的電子郵件通知"

連接器訊息

連接器訊息會傳送至 InterChange Server Express 訊息目標。 根據您的作業系統,訊息將以下列其中一種方法出現:

如需連接器記載的相關資訊,請參閱"連接器代理程式日誌"

為了協助進行疑難排解,在連接器代理程式啟動時會建立暫時日誌檔,其中含有從連接器控制程式取得的 Meta 資料。 Meta 資料是由商業物件規格、內容及支援差異的內容所組成。 檔案名稱為 connectornametmp.log, 位於 ProductDir\Connectors 目錄中。

訊息格式

所有訊息都已格式化,所以可以輕易地過濾。InterChange Server Express 及連接器的記載訊息都使用相同的格式, 如表 15 中所述。 配置商業物件進行流程追蹤訊息時,會使用這些欄位及其他欄位, 這些欄位均在表 15 中以星號指示。 遞送到 InterChange Server Express 的訊息具有下列格式,並使用下列部份或所有參數:

Time: System Name: Thread: MsgType MsgID: SubSystem: FIID: BO: MsgText: BOD:

表 15. 訊息格式
變數 說明
Time 時間戳記:記載的日期,格式為 //日期時間
System 元件類型 (系統識別碼)。它可以是「伺服器」、「協同作業」、「商業物件」或「連接器代理程式」。
Thread 執行緒名稱及執行緒 ID
Name 元件名稱,如 ClarifyConnector。
MsgType 訊息嚴重性。請參閱表 16
MsgID 訊息碼。
SubSystem* 現行系統的子系統。它可以是「事件管理」、「傳訊」、「儲存庫」或「資料庫連接功能」。
FIID* 商業物件的流程起始器 ID。
BO* 商業物件名稱。
MsgText 訊息碼的相關文字。
BOD* 商業物件傾出。商業物件中所含的資料。

下面是伺服器訊息範例: [Time: 2001/06/07 11:01:29.487] [System: Server] [SS: REPOSITORY] [Thread: VBJ ThreadPool Worker (#-1767149274)] [Type: Trace ] [Mesg: Released session REPOSITORY0]

表 16 說明 InterChange Server Express 訊息的類型。

表 16. 訊息類型
類型 說明
參考 只是參考資訊。您不需要採取動作。
警告 InterChange Server Express 選擇的預設狀況。
錯誤 您應調查的嚴重問題。
嚴重錯誤 停止作業且應加以報告的錯誤。
追蹤 指定追蹤層次的追蹤資訊。
流程追蹤 商業物件的流程追蹤資訊。
內部錯誤 應加以調查的嚴重內部問題。
內部嚴重錯誤 停止作業的內部錯誤。應加以報告。

註:
若出現嚴重性為「內部錯誤」或「內部嚴重錯誤」的訊息, 請記錄發生問題的情況,然後聯絡「InterChange Server Express 技術支援」。

系統日誌

InterChange Server Express 日誌

InterChange Server Express 可以將訊息記載到下列目標:

除了管理定期記載之外,InterChange Server Express 還可以在產生錯誤或嚴重錯誤訊息時, 傳送電子郵件訊息給指定的使用者。

依預設,追蹤訊息會傳送至系統日誌檔。在部份情況下,此檔案可能會變得太大,所以建議您指定個別的追蹤檔。 如需設定個別追蹤訊息檔案的指示,請參閱"追蹤檔案"

配置記載與追蹤說明如何設定記載的目標。

若要指定電子郵件通知的收件人,請參閱配置日誌訊息的電子郵件通知

記載/追蹤檔案管理說明如何不讓日誌檔變得太大。

連接器代理程式日誌

連接器代理程式及連接器控制程式具有個別的記載機制。 本節說明連接器代理程式記載。連接器控制程式訊息會傳送至含有 InterChange Server Express 訊息的日誌。

連接器代理程式會將訊息記載到本端目標, 也可以將訊息傳送到 InterChange Server Express 以進行記載。若要指定日誌檔名稱, 請編輯連接器的 LogFileName 內容 (使用「連接器配置程式」),並插入您要使用的日誌檔名稱。

如果您要指定連接器代理程式的記載與追蹤檔案,則必須在啟動代理程式時指定本端配置檔。

預設日誌檔 (位於 STDOUT) 含有連接器所產生的錯誤及參考訊息文字。 Name 是應用程式的名稱。

表 17 說明您可以編輯的內容, 以決定連接器代理程式記載訊息的位置。

表 17. 連接器代理程式日誌訊息內容
內容名稱 說明 值類型
LogAtInterchangeEnd 指定連接器代理程式在本端環境中記載訊息之外,是否還要將訊息傳送給 InterChange Server Express。

在 InterChange Server Express 中,會依據 InterchangeSystem.cfg 檔案, 只要出現伺服器訊息的地方,就會出現連接器代理程式訊息。

true (傳送訊息至 InterChange Server Express 並啟用以電子郵件寄送) 或 false (只在本端環境中記載訊息)。 預設值是 false
LogFileName 指定在本端系統中寫入連接器代理程式訊息的位置。 檔案路徑或標準輸出 (STDOUT)。預設值是 STDOUT

如需配置這些內容的指示,請參閱配置連接器代理程式記載目標的步驟

記載/追蹤檔案管理

當啟動 InterChange 系統時,若日誌檔不存在,則會建立日誌檔, 或若日誌檔已存在,則會附加到檔案中。 若日誌檔的大小沒有限制,檔案會持續成長, 而檔案大小則需視自從前次管理後的時間量及系統上通過的交易量而定。 若日誌檔變得太大,您可能無法開啟它,或應用程式可能需要其他系統資源來寫入檔案。

InterChange Server Express 系統日誌檔可配置為指定的大小,當檔案達到該大小時即自動保存。 若要新增預防措施,您可以指定要當成系統備份使用的保存檔數目。 每一次日誌檔達到大小上限時, 即會將檔案重新命名為新的保存檔。保存檔名稱是衍生自原來的日誌或追蹤檔名稱, 且在名稱中會插入下列字組:

_Arc_ number

例如,使用 5 個保存檔時,若日誌檔名稱是 InterchangeSystem.log, 則第一個建立的保存檔會命名為 InterchangeSystem_Arc_01.log。新日誌檔的空間不足時, InterchangeSystem_Arc_01.log 會更名為 InterchangeSystem_Arc_02.log, 且日誌檔會重新儲存為 InterchangeSystem_Arc_01.log, 並以循環方式依此類推,直到有 5 個保存檔為止。 若有 5 個保存檔,則在建立新的日誌檔時, 即會更名現有的保存檔並增加其號碼,使保存檔數目符合您所配置的數目, 然後刪除最舊的 (保存檔號碼是 05) 檔案。圖 48 顯示了使用此配置的檔案進展。

圖 48. 循環保存記載


如需詳細資料,請參閱配置作業配置記載與追蹤

若沒有配置系統日誌檔的大小限制,則 InterChange Server Express 會寫入日誌, 一直到日誌檔所在的磁碟逐漸填滿;如果不管理磁碟, 則當磁碟空間已滿時,系統就會傳回錯誤訊息。

應定期刪除下列檔案中的資料:

除了上述的日誌檔之外,還有每一個應用程式特有的其他日誌檔。 大部分檔案都是在執行時期建立 (如果它們尚未存在)。 新資訊會附加到任何現有的檔案中。 在繼續備份程序之前,必須先停止提供日誌資訊給檔案的每一個元件。

您可以使用任何檔案管理程序,但建議使用下列週期性的日誌檔案管理:

追蹤檔案

若要疑難排解問題,您可以開啟追蹤。追蹤訊息可以協助您監視在 InterChange Server Express 系統元件中所採取的動作。 追蹤層次定義寫入追蹤檔的明細數量。 追蹤層次愈高,您收到的明細愈多。 在下列各方面,追蹤和記載是不一樣的:

追蹤預設為關閉,因為它所產生的訊息通常會比您所需要的還要詳細。 當 InterChange Server Express 正在執行時,您可以在必要時開啟及關閉追蹤。

InterChange Server Express 的追蹤服務

InterChange Server Express 的追蹤服務一開始是設定在 InterChange Server Express 配置檔的參數中 (依預設,此檔案稱為 InterchangeSystem.cfg 且位於產品的最上層目錄中)。 如需這些參數的詳細資料,請參閱 Windows 版、Linux 版或 OS/400 版的 WebSphere Business Integration Server Express 安裝手冊。您可以在「系統管理程式」的「編輯配置」工具中更新這些參數的設定, 如針對 InterChange Server Express、商業物件及協同作業配置追蹤層次的步驟中所述。

協同作業物件追蹤

您可以追蹤協同作業物件的執行。 追蹤會將有關協同作業物件執行的詳細訊息寫入 InterchangeSystem.cfg 檔案中所指定的日誌目標。 追蹤協同作業是持續性的。協同作業的追蹤層次設定有兩種:系統層次及協同作業層次。

系統層次追蹤會傳回協同作業的執行時期資訊。 例如,若您想要追蹤協同作業的狀態變更,請將系統追蹤層次設定為 3。

您可以將協同作業物件追蹤設定為下列其中一個層次:

表 18. 協同作業物件追蹤層次
追蹤層次 說明
1 追蹤連接器的商業物件的接收及適當範例情況的開始。
2 列印層次 1 的訊息。此外,追蹤每一個範例情況的開始與完成、報告轉遞執行與回復。
3 列印層次 1 和 2 的訊息。此外,追蹤每一個範例情況決策區塊或動作的執行。
4 列印層次 1 到 3 的訊息。此外,依照每一個範例情況,追蹤各商業物件的傳送與接收。
5 列印層次 1 到 4 的訊息。此外,依照每一個範例情況,追蹤各商業物件的傳送與接收, 並列印商業物件中每一個屬性值。

如需配置指示,請參閱"針對 InterChange Server Express、商業物件及協同作業配置追蹤層次的步驟"

連接器追蹤

連接器含有兩種元件:連接器控制程式與連接器代理程式。 這兩種元件可以在網路的不同位置中,並以不同的方式追蹤。

您可以將連接器代理程式及控制器追蹤設定為下列其中一個層次:

表 19. 連接器代理程式及控制程式追蹤層次
追蹤層次 說明
1 追蹤商業物件的起始設定及傳送與接收。
2 列印層次 1 的訊息。此外,針對相同類型的事件,提供比層次 1 更多的詳細資料。
3 列印層次 1 和 2 的訊息。此外,追蹤連接器代理程式及傳訊驅動程式間的訊息交換。
4 列印層次 1 到 3 的訊息。此外,追蹤連接器內部層次間的商業物件傳送。
5 列印層次 1 到 4 的訊息。此外,追蹤連接器內部層次間管理訊息的傳送。

新增或變更的追蹤層次會立即生效。

如果您要指定連接器代理程式的記載與追蹤檔案,則必須在啟動代理程式時指定本端配置檔。

如需配置指示,請參閱"配置連接器追蹤的步驟"

對映追蹤

您可以使用「系統管理程式」來設定追蹤對映。 若要除錯及追蹤對映所建立的資訊及錯誤訊息,追蹤對映是非常有用的。 依預設,會關閉追蹤對映。

如需追蹤對映的詳細資訊,請參閱Map Development Guide。如需配置指示,請參閱"配置對映追蹤的步驟"

商業物件追蹤 (流程追蹤)

商業物件追蹤記載提供一種追蹤方式,可以依據每一個處理點上所產生的通知訊息, 追蹤從某一處理點到另一點的商業物件進度。 例如,使用層次 2 追蹤,當商業物件到達協同作業以進行處理時,即會記載追蹤訊息。

表 20 說明與商業物件追蹤相關的可配置層次:

表 20. 商業物件追蹤層次
追蹤層次 說明
0 不追蹤。
1 事件狀態 (如「順利完成」或「失敗」) 及事件識別資訊。
2 最小的事件追蹤。商業物件進入/結束系統時的相關資訊,如連接器、對映、關係及協同作業。 包含層次 1 資訊。
3 提供層次 2 以上的事件追蹤,以及進入/結束系統時的商業物件傾出。 系統效能影響。
4 詳細的追蹤。提供系統元件的追蹤,如連接器、對映、關係及協同作業,以及將這些追蹤對映到層次 3 事件追蹤。 這個層次的追蹤會影響系統效能。

如需配置指示,請參閱針對 InterChange Server Express、商業物件及協同作業配置追蹤層次的步驟

Web 閘道追蹤

提供兩種層次的 Web 閘道追蹤:最小及最大。 此追蹤可讓您檢視關於閘道上通訊處理程序的執行是否正確的資訊。 閘道追蹤層次是從「閘道配置工具」設定。 如需相關指示,請參閱 System Implementation Guide

表 21 說明與閘道追蹤相關的可配置層次:

表 21. 閘道追蹤層次
追蹤層次 說明
0 不追蹤。
1 最小追蹤 (如連結要求、Socket 開啟等等)。
5 最大追蹤 (如 HTTP/HTTPS 要求,包括所有標題)。

配置日誌訊息的電子郵件通知

記載到 InterChange Server Express 日誌的錯誤及嚴重訊息,也可以利用電子郵件傳送給 InterChange Server Express 系統管理者或任何其他收件人。 依預設,InterChange Server Express 是配置為使用 JavaMail 傳送電子郵件通知,但是您可以配置伺服器使用電子郵件連接器來傳送電子郵件通知。 如需使用電子郵件連接器來配置電子郵件通知的指示,請參閱在系統層次配置電子郵件通知的步驟

註:
若您想要配置協同作業進行電子郵件通知,您必須使用電子郵件連接器。

您可以配置下列元件來傳送錯誤及嚴重訊息給電子郵件收件人:

您可以配置系統層次 (設定於 InterchangeSystem.cfg 檔案)、 協同作業物件層次 (設定為協同作業物件內容) 及連接器層次 (設定為連接器內容) 的電子郵件通知。 若您配置系統層次的電子郵件通知,此配置會套用至該系統中的所有協同作業物件或連接器。 若您配置協同作業物件或連接器層次的電子郵件通知,此配置只會套用至該特定元件,並取代系統配置。

InterChange Server Express 系統中的電子郵件通知支援「簡易郵件傳輸通訊協定 (SMTP)」郵件訊息, 因此,InterchangeSystem.cfg 檔案中的電子郵件收件人值及協同作業電子郵件位址必須是標準網際網路位址。

有效的電子郵件位址項目可以是一或多個完整的網際網路位址 (以逗點區隔)。 例如,兩個收件人的有效項目是:

JohnDoe@company.com,FredSmith@company.com
 

您不能使用個人位址別名,如個人通訊錄中所定義的別名。 然而,有效位址可以是郵件伺服器中所定義的別名,如 Eng@company.com。 在此情況下,郵件伺服器會將別名解碼並傳送電子郵件給別名的所有成員。 例如,解碼的別名可以是 person1@some_company.com, person2@another_company.com 等等。

在系統層次配置電子郵件通知的步驟

請執行下列步驟,以在系統層次配置電子郵件通知:

  1. 開啟「系統管理程式」
  2. 在「InterChange Server 元件管理」檢視畫面中,用滑鼠右鍵按一下伺服器,然後按一下編輯配置

    「系統管理程式」視窗的右上方區段變成一個工具,您可以在此工具中編輯 InterchangeSystem.cfg 檔。

  3. 按一下電子郵件標籤。

    有一個對話框會出現在「系統管理程式」視窗右上方區段,您可在此處輸入必要的參數來配置系統層次的電子郵件通知 (請參閱圖 49)。

    圖 49. 編輯配置,電子郵件標籤


  4. 電子郵件傳送類型清單中,選取電子郵件類型:
  5. 在每一個子系統欄位中,鍵入一或多個有效的電子郵件位址。 位址必須符合 SMTP 標準。
  6. 在「系統管理程式」中,按一下檔案 > 儲存 ServerName。 您輸入的系統層次電子郵件通知資訊會儲存在 InterchangeSystem.cfg 檔中。
  7. 配置連接器郵件的其他步驟: 配置 EmailNotification 商業物件,以便在無法連接到指定的電子郵件收件人時, 保留接收這封電子郵件的收件人電子郵件位址。 為防失敗,如果無法連接到 InterChange Server Express 系統管理者時,應該由郵件管理者 (而不是 InterChange Server Express 系統管理者) 來確定郵件是否已遞送。

    請執行下列動作:

  8. 配置連接器郵件的其他步驟:配置電子郵件連接器。

    請執行下列動作:

在協同作業物件層次配置電子郵件通知的步驟

請執行下列步驟,以設定電子郵件位址接收協同作業的訊息:

  1. 在「系統管理程式」中,跳至「InterChange Server 元件管理」檢視畫面, 用滑鼠右鍵按一下您要配置電子郵件通知的協同作業物件,然後按一下內容

    畫面上會出現「內容」對話框。

  2. 協同作業一般內容標籤的電子郵件通知位址欄位中,輸入有效的電子郵件位址。 位址必須符合 SMTP 標準。
  3. 按一下確定以儲存變更並關閉視窗。
  4. 重新啟動協同作業,讓變更生效。

在連接器層次配置電子郵件通知的步驟

您可以配置特定連接器的電子郵件通知,不過,在協同作業物件層次設定的配置參數會取代在系統層次設定的配置參數。

請執行下列步驟,以配置特定連接器的電子郵件通知:

  1. 在「系統管理程式」中,用滑鼠右鍵按一下您要配置電子郵件通知的連接器,然後按一下編輯定義

    畫面上會出現「快速連接器配置程式」視窗。

  2. 標準內容標籤上,LogAtInterchangeEnd 內容的欄位中,選取 true。這樣會以電子郵件傳送連接器訊息至 InterChange Server Express 日誌。
  3. 按一下檔案 > 儲存 > 至專案
  4. 關閉「快速連接器配置程式」視窗。
  5. 重新啟動連接器,讓變更生效。

配置記載與追蹤

本節說明如何設定訊息記載及追蹤。 您可以在「系統管理程式」中使用「編輯配置」選項,及以手動方式編輯 InterchangeSystem.cfg 檔案,以完成這些設定。 作業說明如下:

"開啟編輯配置工具的步驟"

"配置 InterChange Server Express 記載與追蹤目標的步驟"

配置其他 InterChange Server Express 記載與追蹤參數的步驟

配置連接器代理程式記載目標的步驟

針對 InterChange Server Express、商業物件及協同作業配置追蹤層次的步驟

配置協同作業物件追蹤層次的步驟

配置連接器追蹤的步驟

配置對映追蹤的步驟

開啟編輯配置工具的步驟

InterChange Server Express 必須是在執行中且處於「已連接」狀態,才能使用「編輯配置」工具。 在每個階段作業中,「編輯配置」工具只能管理一個 InterChange Server Express。

請執行下列步驟,以開啟「編輯配置」工具:

  1. 開啟「系統管理程式」。
  2. 在「InterChange Server 元件管理」檢視畫面中,用滑鼠右鍵按一下伺服器實例,然後按一下編輯配置。 「編輯配置」工具會在「系統管理程式」右上角的部份開啟,也就是您編輯 InterchangeServer.cfg 檔案之處

配置 InterChange Server Express 記載與追蹤目標的步驟

當配置這些設定時,請將下列關於 STDOUT 的資訊謹記在心:
Linux

如果您將記載與追蹤設定為 STDOUT,訊息將自動 重新遞送至 $PRODUCTDIR/logs/ics_manager.log.

OS/400

如果您將記載與追蹤設為 STDOUT,訊息將寫入至與「伺服器」工作相關聯的排存檔。

Windows

如果您規劃將 InterChange Server 當成服務執行,則必須將記載與追蹤設定為檔案目標。 將記載及追蹤設定為 STDOUT,可防止 InterChange Server 被配置為 Windows 服務。

請執行下列步驟,以配置 InterChange Server Express 訊息記載與追蹤的目標:

  1. 在「編輯配置」工具中,按一下追蹤/日誌檔標籤。

    畫面上會出現記載與追蹤配置視窗 (請參閱圖 50)。

    圖 50. 「編輯配置」工具,「追蹤/日誌檔」標籤


  2. 記載下,選取系統日誌的目標。 您可以記載到系統主控台及日誌檔,但這個選項只能用於除錯,且只能在開發系統上使用。 請執行下列動作:
  3. 追蹤下,選取系統追蹤的目標。 請執行下列動作:
  4. 若要配置 IBM WebSphere MQ 追蹤,請接受檔案的預設路徑名稱,或是按一下瀏覽按鈕以導覽至日誌檔。
  5. 按一下確定以儲存變更並結束。

您的變更會立即生效,或如果您已經配置了日誌檔,則會儲存它並加上日期, 並使用新輸入的配置來建立新檔案。

配置堆疊追蹤的步驟

啟用 InterChange Server Express 堆疊追蹤後,堆疊追蹤資訊會列印在 InterChange Server Express 日誌檔中。這對新安裝的系統進行疑難排解會很有幫助。

請執行下列步驟,以配置堆疊追蹤特性:

  1. 開啟「編輯配置」工具 (請參閱開啟編輯配置工具的步驟)。
  2. 按一下追蹤/日誌檔標籤。
  3. 選取啟用堆疊追蹤勾選框。 當您啟用堆疊追蹤時,就可以使用追蹤嚴重程度清單。
  4. 追蹤嚴重程度清單中,選取您要列印堆疊追蹤的嚴重程度。 這些選項包括: INFOWARNINGERRORFATAL。當堆疊追蹤列印到日誌檔時,它會列印您選取的程度及該程度之上的所有程度。 比方說,如果您選取 ERROR,則 ERRORFATAL 訊息都將列印在日誌檔中。

配置其他 InterChange Server Express 記載與追蹤參數的步驟

請執行下列步驟,以設定日誌和追蹤檔的檔案大小和保存檔數目:

  1. 開啟「編輯配置」工具 (請參閱開啟編輯配置工具的步驟)。
  2. 按一下追蹤/日誌檔標籤。
  3. 若要限制日誌檔,請選取目的檔案無限制勾選框,並在日誌檔清單中選取代表日誌檔大小上限的數字, 然後再選取位元組KBMBGB
  4. 若要限制追蹤檔,請選取目的檔案無限制勾選框,並在追蹤檔清單中選取代表追蹤檔大小上限的數字, 然後再選取位元組KBMBGB
  5. 若要設定日誌或追蹤保存檔的數目,請在記載追蹤 區段的保存檔數目清單中選取數字。
  6. 停止並重新啟動 InterChange Server Express。

配置連接器代理程式記載目標的步驟

兩個連接器元件有個別的記載機制。 連接器控制程式記載會傳送到 InterchangeServer.log 檔案。 本節說明配置連接器代理程式日誌檔名稱與位置。

如需連接器代理程式記載的背景資訊,請參閱"連接器代理程式日誌"

您可以使用下列其中一種方法,設定連接器代理程式記載的目標:

請執行下列步驟,以使用「快速連接器配置程式」來配置連接器代理程式記載的目標:

  1. 連接至伺服器。
  2. 在「系統管理程式」中,用滑鼠右鍵按一下連接器物件,然後選取編輯定義。 畫面上會出現「快速連接器配置程式」視窗。
  3. 按一下標準內容標籤。
  4. 選取其中一個記載內容值 (如需這些值的說明,請參閱表 17),然後按一下編輯
  5. 欄位中輸入新值,然後按一下確定

    例如,將 LogAtInterchangeEnd 值變更為 true, 表示將訊息傳送至 InterChange Server Express 日誌。若 InterChange Server Express 已配置為記載錯誤及嚴重訊息時要傳送電子郵件,則會同時傳送連接器代理程式訊息的電子郵件。

  6. 必要時,重複步驟 3 和 4 以編輯其他記載內容值。

    例如,若要將連接器代理程式訊息傳送到訊息檔,而不是預設的 STDOUT,請在欄位中輸入檔案的完整路徑名稱。

  7. 重新啟動連接器,使變更生效。
註:
如果您要指定連接器代理程式的記載與追蹤檔案,則必須在啟動代理程式時指定本端配置檔。

針對 InterChange Server Express、商業物件及協同作業配置追蹤層次的步驟

請執行下列步驟,以配置追蹤:

  1. 開啟「編輯配置」工具 (請參閱開啟編輯配置工具的步驟)。
  2. 按一下追蹤層次標籤 (請參閱圖 51)。

    圖 51. 編輯配置工具,追蹤層次標籤


  3. 若要配置子系統追蹤,請在 IBM WebSphere Business Integration 追蹤層次下,針對您要配置的子系統選取追蹤層次

    設定這些追蹤層次,會更新 InterchangeSystem.cfg 檔案中的參數。 如需關於在各種追蹤層次中產生什麼資訊的詳細資料, 請參閱 Windows 版、Linux 版或 OS/400 版的 WebSphere Business Integration Server Express 安裝手冊。

  4. 若要配置協同作業的追蹤,請執行下列動作:
  5. 若要配置商業物件的追蹤,請執行下列動作:
  6. 按一下確定以儲存變更並結束。

    子系統、商業物件及協同作業的追蹤層次會立即生效。

配置協同作業物件追蹤層次的步驟

本節說明可以用來配置協同作業物件追蹤層次的兩種方法之其中一種。 如需替代方法,請參閱針對 InterChange Server Express、商業物件及協同作業配置追蹤層次的步驟

請執行下列步驟,以配置協同作業物件追蹤層次:

  1. 在「系統管理程式」中,移至「InterChange Server 元件管理」檢視畫面, 用滑鼠右鍵按一下協同作業物件,然後按一下內容。 畫面上會出現「內容」對話框。
  2. 請在「協同作業一般內容」標籤上執行下列其中一項動作:

配置連接器追蹤的步驟

請執行下列步驟,以配置連接器追蹤:

  1. 從「系統管理程式」中,用滑鼠右鍵按一下連接器物件,然後按一下 編輯定義。畫面上會出現 「快速連接器配置程式」視窗。
  2. 請執行下列動作之一:
  3. 按一下檔案 > 儲存 > 至專案
  4. 關閉「快速連接器配置程式」。

    這些內容的任何變更都會立即生效。 每當 InterChange Server Express 傳送追蹤訊息時,連接器控制程式的追蹤訊息就會出現;而每當連接器代理程式記載訊息時,連接器代理程式的追蹤訊息就會出現。

    註:
    如果您要指定連接器代理程式的記載與追蹤檔案,則必須在啟動代理程式時指定本端配置檔。

配置對映追蹤的步驟

請執行下列步驟,以設定對映的追蹤層次:

  1. 在「系統管理程式」中,移至「InterChange Server 元件管理」檢視畫面, 用滑鼠右鍵按一下對映物件,然後按一下內容。 畫面上會出現「對映內容頁」 (請參閱圖 52)。

    圖 52. 對映內容頁


  2. 追蹤層次欄位中,輸入適當的值。
  3. 按一下確定

在日誌檢視器中使用追蹤

若要疑難排解問題,您可以開啟追蹤。追蹤訊息可以協助您監視在 WebSphere InterChange Server Express 系統元件中所採取的動作。 追蹤層次定義寫入追蹤檔的明細數量。 追蹤層次愈高,您收到的明細愈多。

追蹤預設為關閉,因為它所產生的訊息通常會比您所需要的還要詳細。 當 InterChange Server Express 正在執行時,您可以在必要時開啟及關閉追蹤。

如需有關追蹤的背景資訊,請參閱追蹤檔案。 如需有關追蹤的配置資訊,請參閱配置記載與追蹤

日誌檢視器及追蹤的概觀

使用「日誌檢視器」以顯示 InterChange Server Express 的追蹤資訊。除了顯示協同作業的除錯追蹤資訊外, 它還可以讓您檢視從某一處理點到另一點的商業物件傳送進度,例如, 當商業物件結束協同作業處理點,然後要傳送到其他協同作業或連接器進行處理時, 或要轉遞到對映階段以進行資料轉換時。 如需流程追蹤的相關資訊,請參閱商業物件追蹤 (流程追蹤)
OS/400

當使用「日誌檢視器」來檢視日誌時,您必須將日誌檔從 OS/400 複製至 Windows 系統, 或是將網路磁碟機對映至 OS/400 系統,然後導覽至日誌檔。

InterChange Server Express 系統訊息記載是用來傳達訊息、元件狀態變更與失敗。

註:
「日誌檢視器」可檢視日誌檔,因此不需要執行 InterChange Server Express。InterChange Server Express 系統管理者必須先設定適當的檔案系統許可權,才能檢視日誌檔。

您可以使用下列方式之一,檢視含有訊息及系統訊息說明的日誌檔:

「日誌檢視器」可讓您查看日誌檔中所包含的所有訊息。 您可以排序及過濾輸出顯示,以及列印、儲存及以電子郵件傳送檔案。

圖 53 顯示以「日誌檢視器」顯示的範例日誌檔。

圖 53. 日誌檢視器


啟動日誌檢視器的步驟

執行其中一項步驟,以啟動「日誌檢視器」:

設定日誌檢視器喜好設定的步驟

請執行下列步驟,以設定「日誌檢視器」喜好設定:

  1. 按一下編輯 > 喜好設定

    畫面上會出現「使用者配置」選項對話框,且已選取一般標籤 (請參閱圖 54)。

    圖 54. 「日誌檢視器使用者」配置選項對話框,「一般內容」標籤


  2. 開啟動作下,選取當您開啟日誌檔時,日誌檔的顯示方式:
  3. 若要變更「日誌檢視器」訊息的背景顏色與字型,請按一下格式標籤。

    畫面上會出現「格式」標籤 (請參閱圖 55)。

    圖 55. 「日誌檢視器使用者」配置選項,「格式」標籤


  4. 選取選項以顯示各種日誌訊息:
  5. 若要變更要顯示哪一個「日誌檢視器」直欄,請按一下直欄標籤。

    即會開啟「直欄」標籤 (請參閱圖 56)。

    圖 56. 「日誌檢視器使用者」配置選項,「直欄」標籤


    此視窗可讓您決定要在「日誌檢視器」中顯示哪些直欄:

日誌檢視器顯示選項的概觀

檢視功能表含有可變更「日誌檢視器」顯示方式的其他選項:

日誌檢視器顯示輸出的概觀

您可以使用數個選項來操作「日誌檢視器」輸出。 在檔案功能表中,有一些選項適用於預覽列印、 列印、儲存、重新整理顯示畫面、傳送至電子郵件收件人及決定頁面設定的樣式、標題及標底。 標題及標底的變數如下:

$F
檔案名稱

$A
應用程式名稱

$P
頁碼

$N
總頁數

$D
日期 (後面可以接著其他參數,例如 $D{%y:%h:%m})

過濾訊息的步驟

請執行下列步驟,以在「日誌檢視器」中過濾訊息:

  1. 按一下檢視 > 過濾 > 使用過濾條件。 畫面上會出現「過濾條件設定」對話框。「過濾條件設定」對話框顯示與記載的訊息格式參數對應的種類 (請參閱表 16 以取得參數的說明清單)。
  2. 選取設定過濾條件下的標籤,以顯示您要用於過濾訊息的項目。 例如,選取「商業物件」標籤以顯示要在過濾中使用的商業物件清單, 若您想要依據訊息的時間戳記來進行過濾,請選取「時間」。 您可以設定多個過濾條件,然後個別使用或彼此搭配使用。
  3. 在顯示的項目清單中,選取您要在「日誌檢視器」中檢視訊息的每個項目。 例如,若您只想檢視與「成本」及「客戶」商業物件相關的訊息, 只要在清單中選取那些商業物件。 若您只想檢視時間戳記介於 2002 年 3 月 5 日上午 9 點與 2002 年 3 月 6 日上午 5 點之間的訊息, 請在時間標籤下選取這些時間範圍。

    您可以使用清單框下的按鈕來選取所有顯示的項目、 清除所有顯示的項目,或反轉您目前選取的選項。

  4. 啟動過濾條件下,選取每一個您要啟動的過濾類型勾選框。 例如,若您想要查看「成本」及「客戶」商業物件的所有訊息 (您在前一步驟中指定的), 只要啟動「商業物件」過濾條件。若只要查看具有特定時間戳記的「成本」與「客戶」商業物件訊息, 請啟動「商業物件」過濾條件與「時間」過濾條件。
  5. 按一下確定。「過濾條件設定」對話框會關閉,並重新整理「日誌檢視器」, 只顯示您在過濾條件中所容許的那些訊息。

請注意,除了依據種類過濾外,您也可以只顯示那些含有特定字串的訊息。 若要執行此作業,請按一下設定過濾條件下的訊息, 輸入您要顯示的訊息特定文字,然後選取啟動過濾條件下的訊息勾選框。

追蹤商業物件流程的步驟

追蹤商業物件的流程 (或存取流程) 可讓您在商業物件的生命週期中,追蹤每一個處理點的進度。 使用「日誌檢視器」,您可以檢查顯示的追蹤訊息來追蹤進度。 每一個商業物件都有一個相關聯的流程起始器 ID,此 ID 只供此目的使用。 若您依照流程起始器 ID 及日期/時間來排序「日誌檢視器」顯示畫面, 則會將商業物件的追蹤訊息聚集在一起,使您可以輕鬆地追蹤其狀態。 依照升冪或降冪方式排序來查看歷程視景或先顯示最新的事件。

註:
只有在商業物件是在 InterChange Server Express 的網域時,才能執行流程追蹤,亦即, 從來源應用程式的連接器控制程式到目標應用程式的連接器控制程式。 當商業物件正由連接器代理程式或應用程式進行處理時,無法執行商業物件流程追蹤。

請執行下列步驟,以追蹤商業物件流程:

  1. 必要的話,設定追蹤日誌檔目標 (請參閱配置記載與追蹤)。
  2. 選取原始觸發商業物件 (不是通用商業物件) 以追蹤及設定追蹤層次 (請參閱針對 InterChange Server Express、商業物件及協同作業配置追蹤層次的步驟)。
  3. 從來源連接器將事件傳送至目標連接器。
  4. 開啟「日誌檢視器」(請參閱啟動日誌檢視器的步驟)。
  5. 設定顯示喜好設定以檢視流程追蹤 (請參閱日誌檢視器顯示選項的概觀)。
  6. 按一下訊息識別碼直欄的錯誤訊息按鈕,以檢視訊息文字。
  7. 按一下商業物件直欄中任何商業物件名稱按鈕,以檢視商業物件中所含的資料。

    此動作會顯示「商業物件檢視器」,它可以讓您將資料儲存到個別檔案中。 然後,您就可以使用「對映」工具或「測試連接器」來讀取該檔案。

Copyright IBM Corp. 2004