配置 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 進一步說明這些參數設定。
參數 | 說明 |
---|---|
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"。 |
應用程式配置檔中的追蹤設定為動態的,且每當儲存或取代檔案即會重讀。如果在編輯檔案後才發現錯誤, 則追蹤檔設定會回復成預設值。