WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

使用應用程式配置檔的追蹤配置

配置 XMS .NET 應用程式之追蹤較好的方式是使用應用程式配置檔。這個檔案中的 Trace 區段含有一些參數,可用來定義所要追蹤的項目、 追蹤檔的位置與容許的大小上限、所用的追蹤檔數目,以及追蹤檔格式。

若要使用應用程式配置檔來啟用追蹤,您只需將檔案放在和您應用程式之執行檔相同的目錄中即可。

您可以依元件和追蹤類型來啟用追蹤。您也可以針對整個追蹤群組來啟用追蹤。您可以針對階層中的元件個別或集體啟用追蹤。可用的追蹤類型有:

下列範例顯示定義在應用程式配置檔之 Trace 區段中的追蹤設定:

<?xml version="1.0" encoding="UTF-8"?>    
<configuration>
    <configSections>
        <sectionGroup name="IBM.XMS">
            <section name="Trace" 
                     type="System.Configuration.SingleTagSectionHandler" />
        </sectionGroup>
    </configSections>

    <IBM.XMS>
        <Trace traceSpecification="*=all=enabled" traceFilePath="" 
               traceFileSize="20000000" traceFileNumber="3" 
               traceFormat="advanced" />
    </IBM.XMS>
 </configuration> 

表 1 進一步說明這些參數設定。

表 1. 應用程式配置檔的追蹤參數設定
參數 說明
traceSpecification=<ComponentName>=<type>=<state>

<ComponentName> 為您想追蹤的類別名稱。您可以在這個名稱中使用 * 萬用字元。例如, *=all=enabled 表示您想追蹤所有類別,而 IBM.XMS.impl.*=all=enabled 表示您只需要 API 追蹤。

<type> 可為下列任何追蹤類型:
  • 全部
  • 除錯
  • 事件
  • 進入/跳出

<state> 可為 enabled 或 disabled。

您可以使用 ':'(冒號)定界字元,藉以串連多個追蹤元素。

traceFilePath="<filename>"
如果您沒有指定 traceFilePath,或雖有指定 traceFilePath 但卻是包含一個空字串,則會將追蹤檔放在現行目錄中。若要將追蹤檔儲存在指名的目錄中, 請在 traceFilePath 中指定目錄名稱,例如:
traceFilePath="c:\somepath"
traceFileSize="<size>" 容許的追蹤檔大小上限。當檔案抵達此大小時,即會保存並重新命名。預設上限為 20 KB, 亦即指定為 traceFileSize="20000000"
traceFileNumber="<number>" 所要保留的追蹤檔數目。預設值為 4(一個作用中的檔案,三個保存檔)。容許數目的下限是 2。
traceFormat="<format>"

預設的追蹤格式為 basic。如果您指定 traceFormat="basic",或是沒有指定 traceFormat, 或是有指定 traceFormat 但卻包含一個空字串,則會使用這種格式來產生追蹤檔。

如果您需要和追蹤分析器工具相容的追蹤, 您必須指定 traceFormat="advanced"

應用程式配置檔中的追蹤設定為動態的,且每當儲存或取代檔案即會重讀。如果在編輯檔案後才發現錯誤, 則追蹤檔設定會回復成預設值。

相關概念
使用 XMS 環境變數的追蹤配置

Concept topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)