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

已知的問題和暫行解決方案

1.0 日誌和追蹤分析器
 1.1 視圖
  1.1.1 未適當重新整理「日誌導覽器」視圖
  1.1.2 進階過濾器不會過濾不含相符屬性值的日誌記錄
  1.1.3 「側寫和記載」視景可能會遺漏工具列按鈕和功能表項目
 1.2 匯入日誌
  1.2.1 匯入遠端日誌檔時的問題
  1.2.2 在 Linux 和 AIX 中匯入日誌檔
  1.2.3 匯入 WebSphere Application Server trace.log
  1.2.4 匯入和檢視追蹤檔
  1.2.5 日誌和追蹤分析器不支援 Agent Controller 安全特性
  1.2.6 無法利用 IBM Agent Controller 第 5 版匯入某些日誌檔
  1.2.7 「記憶體不足」異常狀況
  1.2.8 在 Linux GTK 驅動程式上,在「匯入日誌檔」精靈中新增日誌檔時,發生索引超出界限的錯誤
  1.2.9 無法在 Linux GTK 驅動程式上,從 .metadata 資料夾中匯入 LoggingUtil.log 檔
  1.2.10 無法利用規則型剖析器匯入需要轉換的日誌檔
  1.2.11 不支援利用靜態剖析器連續監視日誌檔
  1.2.12 不會顯示「匯入日誌檔時發生錯誤」
  1.2.13 匯入 WebSphere Application Server activity.log 檔有所限制
  1.2.14 匯入不同語言環境產生的日誌檔有所限制
  1.2.15 匯入失敗,出現 InvocationTargetException 訊息
 1.3 其他
  1.3.1 在 Linux GTK 驅動程式上,無法適當顯示「新建日誌相互關係」精靈
  1.3.2 不會遵循在最初啟動工作台之後的外掛程式記載層次修正
  1.3.3 利用 Windows XP unzip 公用程式解壓縮的問題
  1.3.4 在含 IBM JVM 的 Red Hat Linux 8.0 版中建立範例時毀損
2.0 側寫工具
  2.1 「序列圖」視圖中不支援「代理程式互動」和「程序互動」視圖
  2.2 「序列圖」視圖會顯示未對齊的傳回呼叫
  2.3 側寫導覽器的「重新整理視圖」指令對追蹤互動無效
  2.4 「在伺服器中側寫」的側寫選項不適用於 J2EE 要求側寫程式
  2.5 *新過濾器集會在非英文平台中建立英文的過濾器規則,當儲存時,會將英文過濾器規則當作 INCLUDE 來處理


1.0 日誌和追蹤分析器

1.1 視圖

1.1.1 未適當重新整理「日誌導覽器」視圖

當在「資源導覽器」視圖中進行刪除時,不會重新整理「日誌導覽器」視圖。

您可以用滑鼠右鍵按一下「日誌導覽器」視圖,再從快速功能表中選取「從本端重新整理」來手動重新整理。

1.1.2 進階過濾器不會過濾不含相符屬性值的日誌記錄

當在日誌視圖中使用進階過濾時,如果日誌記錄不含用來進行比較的進階過濾器表格所指定之欄位的相符的屬性值,便不會過濾這些日誌記錄。

目前沒有暫行解決方法。

1.1.3 「側寫和記載」視景可能會遺漏工具列按鈕和功能表項目

如果您先前側寫了 Java 應用程式或任何其他啟動配置類型,可能會在沒有完全啟動側寫和記載功能的情況下開啟「側寫和記載」視景。 因此,當您返回「側寫和記載」視景時,大部分工具列按鈕和功能表項目都可能不會出現。

如果要顯示遺漏的工具列按鈕和功能表項目,請執行下列動作:

  1. 視窗功能表中,選取喜好設定
  2. 展開工作台,選取功能
  3. 選取啟用側寫和記載功能的勾選框來啟用這項功能。
  4. 按一下確定
  5. 關閉再重新開啟「側寫和記載」視景。

如果要徹底避免這個問題,請先啟用側寫和記載功能,再進行任何側寫。

1.2 匯入日誌

1.2.1 匯入遠端日誌檔時的問題

當匯入遠端日誌檔(如「檔案 > 匯入... > 日誌檔」)時,在重新整理側寫監視器的視圖(如「側寫 >b> 重新整理視圖」)之後,有可能日誌視圖不會出現任何日誌項目, 也可能出現一個「記載訊息」對話框,指出在等待 30 秒之後,本端用戶端尚未開始監視遠端日誌剖析器。

這個問題是由於網絡等待時間所造成,您可以增加 Agent Controller 等待本端用戶端開始監視遠端日誌剖析器的時間,來修正這個問題。 如果要暫時解決這個問題,請嘗試下列步驟:

  1. 嘗試重新匯入日誌檔。
  2. 如果症狀持續存在,請將下列項目新增至 Agent Controller 配置中的遠端 RemoteLogParserLoader 應用程式(如 <Agent Controller 的安裝目錄>/config/serviceconfig.xml)中:
      <Application configuration="default" executable="RemoteLogParserLoader" 

    location="%JAVA_PATH%" path="%JAVA_PATH%\java.exe">

    ...
    <Parameter position="prepend"
    value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx">
    </Parameter>
    ...
    </Application>
    其中 xxxxx 是等待時間上限(毫秒)(也就是大於 30000)。
  3. 在更新之後,請重新啟動 Agent Controller,再嘗試重新匯入日誌檔。
1.2.2 在 Linux 和 AIX 中匯入日誌檔

部分日誌檔匯入作業完全無法在 Linux 和 AIX 平台中運作。

當使用者沒有存取日誌檔的適當許可權時,便會發生這個情況。 如果要解決這個問題,您應該將日誌檔複製到使用者的起始目錄中,從其中匯入。

1.2.3 匯入 WebSphere Application Server trace.log

當匯入 WebSphere Application Server trace.log 檔時,會建立內部的相互關係。

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

1.2.4 匯入和檢視追蹤檔

利用日誌分析器追蹤輸出格式來產生的 WebSphere Application Server 5.0.1 版或較舊版本的追蹤檔,無法利用日誌和追蹤分析器來匯入和檢視。

如果要暫時解決這項限制,請將 WebSphere Application Server 追蹤輸出格式設成「基本」或「進階」,您才能產生要利用日誌和追蹤分析器來匯入和檢視的追蹤檔。

1.2.5 日誌和追蹤分析器不支援 Agent Controller 安全特性

如果在啟用安全的情況下安裝 Agent Controller,您將無法側寫應用程式或匯入日誌檔

如果要暫時解決這項限制,請停用安全來重新安裝 Agent Controller。

1.2.6 無法利用 IBM Agent Controller 第 5 版來匯入某些日誌檔

activity.log 以外的遠端日誌檔無法利用第 5 版 IBM Agent Controller 來匯入。 當從遠端匯入日誌檔時,遠端機器中的 Agent Controller 必須設在日誌和追蹤分析器的相同層次或更高層次上,以便進行自主運算。

如果要暫時解決這項限制,請將日誌和追蹤分析器所檢附的 IBM Agent Controller 安裝在遠端機器中。

1.2.7 「記憶體不足」異常狀況

可匯入工作區和在「日誌和追蹤分析器」中開啟的日誌檔最多為 25MB。開啟日誌檔的時間量會視檔案中的日誌記錄數而定,且您可能收到「記憶體不足」異常狀況。

如果要暫時解決這個問題,請編輯 ac.bat 或 ac.sh,並將 "-Xmx" 選項的值從 "500" 增加為較高的值,如 "1000M"(增加之後,啟動速度會變慢),來增加記憶體,或在機器中新增更多實體記憶體。 另外,您也可以使用日誌和追蹤分析器的大型日誌支援特性。

1.2.8 在 Linux GTK 驅動程式上,在「匯入日誌檔」精靈中新增日誌檔時,發生索引超出界限的錯誤

在匯入日誌檔期間,當您試圖在「新增日誌檔」精靈中按一下確定時,會出現索引超出界限的錯誤。 這是因為新增的日誌檔沒有選取版本。

請確定已在「新增日誌檔」精靈「詳細資料」標籤之下的版本下拉清單中,選取了有效的版本選項。

1.2.9 無法在 Linux GTK 驅動程式上,從 .metadata 資料夾中匯入 LoggingUtil.log 檔

任何工作區目錄之 .metadata 資料夾中的 LoggingUtil.log 檔都無法匯入,因為匯入日誌精靈的「選取檔案」對話框不會顯示 .metadata 資料夾。

如果要暫時解決這個問題,請將 LoggingUtil.log 檔從 .metadata 資料夾複製到其他可見的資料夾目錄中。

1.2.10 無法利用規則型剖析器匯入需要轉換的日誌檔

無法利用對應的規則型剖析器,來匯入需要從原生格式轉換成文字格式的日誌檔(利用「檔案 > 匯入 > 日誌檔」)。 下列日誌檔會受到影響:

如果要暫時解決這項限制,如果有對應的靜態型剖析器,請使用它。

1.2.11 不支援利用靜態剖析器連續監視日誌檔

您不能連續利用靜態 Java 剖析器類別來監視日誌檔。 如果有規則型剖析器,請利用規則型剖析器來連續監視這些日誌檔。

1.2.12 不會顯示「匯入日誌檔時發生錯誤」

如果匯入日誌檔時發生錯誤,有時不會顯示錯誤訊息,且日誌視圖中不會出現記錄,日誌視圖中的記錄所顯示的資料也可能不正確。 請確定已選擇正在匯入的日誌檔的正確日誌類型和版本。 日誌和追蹤分析器不會在匯入的日誌檔類型上進行任何驗證。

1.2.13 匯入 WebSphere Application Server activity.log 檔有所限制

當從非英文機器或在非英文機器中匯入 WebSphere Application Server 活動日誌檔時,規則型日誌檔剖析器無法將日誌記錄資料順利對映至 Common Base Event。 相反地,部分日誌記錄資料可能會出現在 Common Base Event 的不正確的欄位中。

如果要暫時解決這個問題,當從非英文機器或在非英文機器中匯入 WebSphere Application Server 活動日誌檔時,請使用靜態日誌檔剖析器。

1.2.14 匯入不同語言環境產生的日誌檔有所限制

當匯入的日誌檔所包含之時間戳記的語言環境不是日誌和追蹤分析器執行時所用的語言環境時,規則型日誌檔剖析器有時無法正確剖析時間戳記和其他日誌記錄資料。 比方說,將英文的 IBM HTTP Server 存取日誌檔匯入在日文機器中執行的日誌和追蹤分析器時,產生的 Common Base Events 中的 creationTime 值為零,Common Base Event 訊息欄位會空白。

如果要暫時解決這個問題,當匯入的日誌檔所包含之時間戳記的語言環境與現行機器的語言環境不同時,如果有靜態日誌檔剖析器,請使用靜態日誌檔剖析器。

1.2.15 匯入失敗,出現 InvocationTargetException 訊息

如果未正確安裝日誌和追蹤分析器,它的部分檔案會遺失,匯入日誌檔可能會失敗並出現下列記載訊息:

java.lang.reflect.InvocationTargetException

如果要暫時解決這個問題,請重新安裝日誌和追蹤分析器。 附註:當在 Windows XP 中安裝時,請勿使用原生 Windows XP unzip 公用程式。 請參閱下面的利用 Windows XP unzip 公用程式解壓縮的問題,以取得詳細資料。

1.3 其他

1.3.1 在 Linux GTK 驅動程式上,無法適當顯示「新建日誌相互關係」精靈

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

如果要暫時解決這個問題,請嘗試調整精靈頁面大小,以顯示「所選的日誌」清單和動作按鈕。 另一個暫行解決方案是在按一下「新建日誌相互關係」按鈕之前,在「日誌導覽器」視圖中選取相互關係的日誌檔。

1.3.2 不會遵循在最初啟動工作台之後的外掛程式記載層次修正

如果您在最初啟動工作台之後,又在外掛程式 plugin.xml 檔中修改了外掛程式的記載層次(利用 com.ibm.etools.common.logging.commonLoggingOptions 或 com.ibm.etools.logging.util.loggingOptions 延伸點), 後續啟動工作台不會遵循這項變更。 在最初啟動工作台時,Eclipse 執行時期會快取外掛程式 plugin.xml 檔所指定的記載層次。 雖然 plugin.xml 檔中進行了修改,但後續啟動工作台仍會使用快取的外掛程式記載層次的值。

如果要暫時解決這個問題,請刪除 <工作台安裝目錄>\configuration 目錄,再重新啟動工作台。 另外,您也可以在「記載」喜好設定頁面(視窗 > 喜好設定 > 記載)中修改外掛程式的記載層次,再重新啟動工作台。

1.3.3 利用 Windows XP unzip 公用程式解壓縮的問題

當在 Windows XP 中安裝日誌和追蹤分析器時,利用 Windows XP 原有的解壓縮公用程式來解壓縮日誌和追蹤分析器執行時期檔會發生問題。 無法解壓縮部分目錄和檔案。這個問題的結果是無法利用日誌和追蹤分析器來匯入某些日誌檔類型。

如果要暫時解決這個問題,當在 Windows XP 中安裝時,請使用另一個 unzip 公用程式,如 WinZip 或 UnZip。

1.3.4 在含 IBM JVM 的 Red Hat Linux 8.0 版中建立範例時毀損

當在日誌和追蹤分析器中,利用「建立範例」精靈(新建 > 範例)來建立範例時,工作台會毀損。 當「建立範例」精靈試圖在建立步驟中開啟 readme.html 檔時,便會出現這個情況。 在含 IBM 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:請開啟 Motif 2.1(已併入);SWT HTML 檢視器需要 Mozilla 1.4GTK2。

2.0 側寫工具

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

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

這個問題目前沒有暫行解決方法。

2.2 「序列圖」視圖會顯示未對齊的傳回呼叫

「序列圖」視圖可能會顯示未對齊的傳回呼叫,傳回呼叫會指向空白字元而不是方法節點。

這個問題目前沒有暫行解決方法。

2.3 側寫導覽器的「重新整理視圖」指令對追蹤互動無效

側寫導覽器的「重新整理視圖」指令對追蹤互動無效。

暫行解決方法是在側寫樹狀結構中選取另一個節點,再重新選取前一個節點。

2.4 「在伺服器中側寫」的側寫選項不適用於 J2EE 要求側寫程式

「在伺服器連接中側寫」精靈可讓您配置側寫選項(如側寫集或側寫過濾器)。 這些側寫選項不適用於選取要連接的任何 J2EE 要求側寫程式。 這些側寫選項只適用於 PiAgent 側寫程式。

*2.5 新過濾器集會在非英文平台中建立英文的過濾器規則,當儲存時,會將英文過濾器規則當作 INCLUDE 來處理

當在非英文工作台中建立新的過濾器集時,開始時,新過濾器目標是英文。 此外,英文過濾器規則會被忽略,當儲存時,會一律當作 INCLUDE 來處理。

暫行解決方法是利用套裝的過濾器集來側寫,且修改(新增/移除)它們的側寫過濾器,或套用和關閉啟動精靈來儲存新的過濾器集,在側寫之前,先重新開啟和修改它們。

附註:6.0.0.1 版已修正這個問題。

返回主要 Readme 檔