日誌和追蹤分析器版本注意事項

© Copyright International Business Machines Corporation 2000, 2007. All rights reserved.US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

版本注意事項

1.0 已知的限制、問題及暫行解決方案
   1.1「日誌」視圖中的「過濾」和「強調顯示」功能有問題
   1.2 匯入遠端日誌檔時發生問題
   1.3 在 Linux 和 AIX 上匯入日誌檔
   1.4 匯入 WebSphere 應用程式伺服器 trace.log
   1.5 記憶體不足異常狀況
   1.6 DB2 Express 診斷日誌顯示的日誌事件不符合規格
   1.7 未驗證匯入的日誌檔類型
   1.8 匯入不同語言環境下產生的日誌檔時受到限制
   1.9 使用「規則」剖析器從 AIX 匯入 WebSphere 應用程式伺服器活動日誌失敗
   1.10 匯入日誌檔時不支援過濾「通用基礎事件」複式類型
   1.11 同時匯入多個日誌檔時發生問題
   1.12 不支援用戶端使用相同的資料庫帳戶來同時存取
   1.13 資源路徑衝突
   1.14 即使選擇有效,「大型資源支援」喜好設定仍然停用
   1.15 改進大型日誌支援的效能
   1.16 間歇性 SQL 異常狀況
   1.17 如果尚未套用喜好設定,測試連線會傳回錯誤
   1.18 分析大型日誌時不支援 XPath 表示式
   1.19 大型日誌只顯示一個 contextDataElement
   1.20 在 Linux GTK 驅動程式上無法正常顯示「新建日誌相互關係」精靈
   1.21 在有 IBM JVM 的 Red Hat Linux 8.0 版上建立範例時失敗
   1.22 只有 TPTP 格式的症狀資料庫可從「日誌導覽器」工具列和蹦現功能表中建立
   1.23 無法處理大於 1024 位元組的訊息
   1.24 使用複式元素時,「症狀編輯器」產生的 XPATH 規則無效
   1.25「序列圖」視圖中不支援「代理程式互動」和「程序互動」視圖
   1.26「側寫導覽器」的「重新整理視圖」指令不適用於「追蹤互動」

1.0 已知的限制、問題及暫行解決方案

1.1 「日誌」視圖中的「過濾」和「強調顯示」功能有問題

在「日誌視圖」中,「過濾」和「強調顯示」功能無法處理「日誌」事件的複式元素(例如 sourceComponentId)

1.2 匯入遠端日誌檔時發生問題

匯入遠端日誌檔時(檔案 > 匯入 > 側寫和記載 > 日誌檔),在重新整理「側寫監視器」的視圖之後,「日誌視圖」中未顯示日誌項目(設定檔 > 重新整理視圖),或出現「記載訊息」對話框,表示本端用戶端在等待 30 秒之後仍未開始監視遠端日誌剖析器。
這是網路等待時間引起的問題,可加長 Agent Controller 等待本端用戶端開始監視遠端日誌剖析器的時間來解決。為了解決這個問題,請嘗試下列步驟:


嘗試重新匯入日誌檔。

如果症狀持續發生,請在 Agent Controller 的配置中將下列項目新增至遠端 RemoteLogParserLoader 應用程式(例如,<Agent Controller 的安裝目錄>/plugins/com.ibm.etools.logging.parsers/config/pluginconfig.xml):
<Application configuration="default" executable="RemoteLogParserLoader"
extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
...
<Parameter position="prepend"
value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/>
...
</Application>

其中,xxxxx 是最長等待時間(毫秒)(例如大於 30000)。
完成更新之後,請重新啟動 Agent Controller,再嘗試重新匯入日誌檔。

1.3 在 Linux 和 AIX 上匯入日誌檔

在 Linux® 和 AIX® 平台上有時完全無法匯入日誌檔。

當使用者沒有適當的許可權可存取日誌檔時會發生這種情形。為了解決這個問題,應該將日誌檔複製到使用者的起始目錄,再從此處匯入。

1.4 匯入 WebSphere 應用程式伺服器 trace.log

匯入 WebSphere® 應用程式伺服器 trace.log 檔案時會建立「內部相互關係」。

使用者不應該刪除這些相互關係,因為其中包含相關的資訊指出相對應的代理程式的內部結構。

1.5 記憶體不足異常狀況

最大 25MB 的日誌檔可匯入工作區。開啟日誌檔所需的時間視檔案中的日誌記錄數而定,也可能發生「記憶體不足」異常狀況。

為了解決這個問題,請使用大型日誌支援特性。

1.6 DB2 Express 診斷日誌顯示的日誌事件不符合規格

如果匯入 IBM DB2® Express 診斷日誌,顯示的「日誌」事件結果未完全符合「日誌」事件規格。這是因為將 DB2 診斷日誌轉換成「日誌」事件所用的 db2diag.exe 公用程式設計有錯誤。不然就不影響匯入作業。目前尚無暫行解決方法,只能靜待 db2diag.exe 修正。 

1.7 未驗證匯入的日誌檔類型

未驗證匯入的日誌檔類型。匯入日誌檔時,請確定已對匯入的日誌檔選擇正確的日誌類型和版本。如果匯入期間發生問題,則「日誌視圖」中不會顯示記錄或顯示的記錄不正確,且畫面上會顯示錯誤訊息。如需錯誤的詳細資訊,請檢視錯誤對話框中的詳細資料。 

1.8 匯入不同語言環境下產生的日誌檔時受到限制

在匯入日誌檔時,如果日誌檔包含的時間戳記所用的語言環境和執行工作台的語言環境不同,則規則型日誌檔剖析器有時無法正確剖析時間戳記及其他日誌記錄資料。例如,將英文版 IBM HTTP Server 存取日誌檔匯入日文版機器時,在產生的「日誌」事件中,creationTime 值是零,「日誌」事件 msg 欄位是空白。

為了解決這個問題,在匯入日誌檔時,如果日誌檔包含的時間戳記所用的語言環境和現行機器語言環境不同,請在「匯入日誌」精靈的「詳細資料」標籤上指定日誌檔的語言環境(如果有語言環境欄位的話)。

1.9 使用「規則」剖析器從 AIX 匯入 WebSphere 應用程式伺服器活動日誌失敗

使用「規則」剖析器從 AIX 系統匯入二進位 WAS 活動日誌時失敗,錯誤對話框顯示下列錯誤:

IWAT0030E 遠端日誌剖析器在執行期間發生錯誤
"com.ibm.etools.logging.adapter.config.StaticParserExtension":

IWAT0412E 剖析日誌檔 /home/tfoun/logs/activity.log 時發生錯誤。
java.lang.Exception:IWAT0239E 轉換器指令失敗:java.lang.Exception:
IWAT0238E 轉換器程序結束時的結束值是 1

在 AIX 上以轉換器指令將二進位日誌檔轉換成可剖析的文字時失敗。為了解決這個問題,請使用「靜態」剖析器來匯入二進位活動日誌檔,或使用 WAS showlog 公用程式將二進位活動日誌檔轉換成文字,再匯入產生的文字檔。WAS showlog 公用程式位於 WAS 安裝目錄的 bin 目錄中。例如,使用下列指令將二進位日誌檔轉換成文字檔 activity.txt:

/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt

然後匯入 activity.txt。

1.10 匯入日誌檔時不支援過濾「通用基礎事件」複式類型

指定要匯入的日誌檔時,您可以建立進階過濾器。在新增過濾器內容對話框中,屬性欄位有組合框。這個組合框列出許多「日誌」事件內容。但不會列出「日誌」事件內容的複式類型。 

1.11 同時匯入多個日誌檔時發生問題

同時匯入多個日誌檔時,匯入的記錄可能有不正確的日期。為了解決這個問題,請一次匯入一個檔案。 

1.12 不支援用戶端使用相同的資料庫帳戶來同時存取

用戶端同時存取資料庫可能鎖定部分表格。若要將表格解除鎖定,請重新啟動「工作台」和資料庫伺服器。

1.13 資源路徑衝突

如果多個工作區使用相同的資料庫和資料庫帳戶,可能導致資源路徑衝突,資源將不會存入資料庫。

為了解決這個問題,請在每個工作區中使用不同的專案和監視器名稱,以避免資源路徑衝突。

1.14 即使選擇有效,「大型資源支援」喜好設定仍然停用

在 Linux/GTK 中,在「大型資源支援」喜好設定頁面上,即使選取有效的資料庫類型,資料庫設定欄位仍然停用。

為了解決這個問題,請選取 DB2 做為資料庫類型,再套用設定。關閉再重新開啟喜好設定對話框;欄位將會啟用。

1.15 改進大型日誌支援的效能

為了改進大型日誌支援的效能,請在匯入大型日誌之後執行下列指令:

db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x /scripts/runStatsForAllHyadesTablesDB2-8.1.sql
其中,x_x_x 是外掛程式目錄上的版本號碼。

1.16 間歇性 SQL 異常狀況

偶而會發生下列 SQL 異常狀況:

com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031

發生這個問題時,如果是以網路模式使用 DB2 或 Cloudscape™,請重新啟動工作台和資料庫。發生這個異常狀況時所匯入的日誌無效,必須重新匯入。

1.17 如果尚未套用喜好設定,測試連線會傳回錯誤

在「喜好設定」對話框的「側寫和記載」區段的「大型日誌支援」頁面中,如果在套用變更至設定之前按下測試連線,可能會發生連線錯誤。為了避免這個問題,請在完成任何設定變更之後按一下套用,然後再按一下測試連線

1.18 分析大型日誌時不支援 XPath 表示式

分析大型日誌時不支援下列 XPath 表示式。
    <expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>

1.19 大型日誌只顯示一個 contextDataElement

如果 DB2 用於大型日誌支援,則在「日誌」視圖中,一個事件只顯示一個 contextDataElement,即使該事件有多個 contextDataElement 也一樣。

1.20 在 Linux GTK 驅動程式上無法正常顯示「新建日誌相互關係」精靈

在「新建日誌相互關係」精靈中,只顯示「可用的日誌」清單,且清單是空的。這是因為只出現精靈頁面的左半部。

為了解決這個問題,請嘗試重新調整精靈頁面的大小,讓「選取的日誌」清單和動作按鈕出現。另一種辦法是先在「日誌導覽器」視圖中選取相互關係的日誌檔,再按一下「新建日誌相互關係」按鈕。

1.21 在有 IBM JVM 的 Red Hat Linux 8.0 版上建立範例時失敗

使用「建立範例」精靈來建立範例時(新建 > 範例),工作台毀損。當「建立範例」精靈嘗試在建立過程中開啟 readme.html 檔時會發生這種情形。這個問題出現在有 IBM Java™ 虛擬機器 (JVM) 的 Red Hat Linux 8.0 版,算是 SWT 錯誤 (https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515)。

為了解決這個問題,請嘗試在 ac.sh 中加上 -Xj9 做為 JVM 引數,指定以 IBM J9 JVM 來啟動。(例如,./eclipse -vmargs -Xj9 -Xmx500m)。如需在 Red Hat Linux 8.0 版上執行 SWT 的相關資訊,請參閱 SWT FAQ (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html)。

附註:根據 Eclipse 參考平台表 (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments),只支援下列 Linux 系統:GTK 2.2.1 版 + 小組件工具集及相關程式庫(GLib、Pango);SWT HTML 檢視器需要 Mozilla 1.4GTK2。其他 Linux 系統上的 Motif:Open Motif 2.1(含);SWT HTML 檢視器需要 Mozilla 1.4GTK2。

1.22 只有 TPTP 格式的症狀資料庫可從「日誌導覽器」工具列和蹦現功能表中建立

由於 TPTP 限制,使用者無法從日誌導覽器工具列按鈕和快速功能表中建立兩種症狀資料庫。解決方法是從工作台功能表中選取檔案 > 新建 > 其他 > 側寫和記載,再選擇您要建立的症狀資料庫類型。 

1.23 無法處理大於 1024 位元組的訊息

在 XPath 規則和 IBM 相關性規則中,msg「日誌」事件內容中的字串不可超過 1024 位元組。如果字串超過 1024 位元組,將不予處理。

1.24 使用複式元素時,「症狀編輯器」產生的 XPATH 規則無效

在使用「日誌」事件的複式元素時(例如 sourceComponentID),「症狀編輯器」產生的 XPATH 規則無效。 

1.25「序列圖」視圖中不支援「代理程式互動」和「程序互動」視圖

日誌檔的「序列圖」視圖中不支援「代理程式互動」視圖和「程序互動」視圖。

這個問題目前尚無暫行解決方法。

1.26「側寫導覽器」的「重新整理視圖」指令不適用於「追蹤互動」

「側寫導覽器」的「重新整理視圖」指令不適用於「追蹤互動」。不過,追蹤互動會定期自行重新整理。

暫行解決方法是先在「側寫」樹狀結構中選取另一個節點,然後再選取一次前一個節點。