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>는 사용 가능 또는 사용 불가능할 수 있습니다. ‘:'(콜론) 분리문자로 구분하여 여러 추적 요소를 함께 사용할 수 있습니다. |
traceFilePath="<filename>" | traceFilePath를 지정하지 않거나 traceFilePath가
있지만 빈 문자열이 포함된 경우 추적 파일은 현재 디렉토리에 저장됩니다.
추적 파일을 이름 지정된 디렉토리에 저장하려면 traceFilePath에 디렉토리
이름을 지정하십시오. 예를 들면 다음과 같습니다.
traceFilePath="c:\somepath" |
traceFileSize="<size>" | 추적 파일의 최대 허용 크기. 파일이 이 크기가 되면 아카이브되고 이름이 바뀝니다. 기본 최대 크기는 20KB이며 traceFileSize="20000000"으로 지정됩니다. |
traceFileNumber="<number>" | 보관할 추적 파일 수. 기본값은 4입니다(활성 파일 1 및 아카이브 파일 3). 허용되는 최소값은 2입니다. |
traceFormat="<format>" | 기본 추적 형식은 기본입니다. traceFormat="basic"을 지정하거나 traceFormat을 지정하지 않은 경우 또는 traceFormat이 있지만 빈 문자열이 포함된 경우 추적 파일은 이 형식으로 생성됩니다. 추적 분석기 도구와 호환되는 추적이 필요하면 traceFormat="advanced"를 지정해야 합니다. |
응용프로그램 구성 파일의 추적 설정값은 동적이므로 파일이 저장되거나 바뀔 때마다 다시 읽힙니다. 파일 편집 후 파일에 오류가 있으면 추적 파일 설정값이 기본값으로 돌아갑니다.