trace 요소(ASP.NET 설정 스키마)

아티클
05/27/2012

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

추적 결과를 수집, 저장 및 표시하는 방법을 제어하는 ASP.NET 코드 추적 서비스를 구성합니다.

<trace 
   enabled="true|false"
   localOnly="true|false"
   pageOutput="true|false"
   requestLimit="integer" 
   mostRecent="true|false"
   writeToDiagnosticsTrace="true|false"
   traceMode="SortByTime|SortByCategory"
/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
enabled	선택적 Boolean 특성입니다. 응용 프로그램에 대해 추적을 설정할지 여부를 지정합니다. Trace.axd 뷰어를 사용하려면 추적이 설정되어 있어야 합니다. 기본적으로 Trace.axd 뷰어는 httpHandlers 요소에 추가됩니다. 기본값은 false입니다.
localOnly	선택적 Boolean 특성입니다. 추적 뷰어(Ttrace.axd)를 호스트 웹 서버에서만 사용하도록 할 것인지 지정합니다. 값이 false이면 모든 컴퓨터에서 추적 뷰어를 사용할 수 있습니다. 기본적으로 Trace.axd 뷰어는 httpHandlers 요소에 추가됩니다. 기본값은 true입니다.
mostRecent	선택적 Boolean 특성입니다. 응용 프로그램 수준의 최신 추적 출력을 표시하고 requestLimit에 지정된 제한을 초과하는 이전 추적 데이터를 삭제할지 여부를 지정합니다. 값이 false이면 requestLimit 특성에 지정된 값이 될 때까지 요청에 대해 추적 데이터가 표시됩니다. 이 특성은 .NET Framework 버전 2.0에서 새로 도입되었습니다. 기본값은 false입니다.
pageOutput	선택적 Boolean 특성입니다. 추적 결과를 각 페이지의 끝에 렌더링할지 여부를 지정합니다. 값이 false이면 추적 유틸리티를 통해서만 추적 출력에 액세스할 수 있습니다. 기본값은 false입니다.
requestLimit	선택적 Int32 특성입니다. 서버에 저장할 추적 요청 수를 지정합니다. 제한 값에 도달하고 mostRecent 특성이 false이면 추적이 자동으로 해제됩니다. 최대 요청 제한은 10,000이며, 10,000보다 큰 값을 지정하면 ASP.NET에서 자동으로 10,000으로 지정합니다. 기본값은 10입니다.
traceMode	선택적 TraceDisplayMode 특성입니다. 추적 정보의 표시 순서를 지정합니다. traceMode 특성은 다음 값 중 하나일 수 있습니다. 값설명 SortByCategory 추적 정보를 사용자 정의 범주에 따라 사전순으로 표시하도록 지정합니다. SortByTime 추적 정보를 처리 순서대로 표시하도록 지정합니다. 기본값은 SortByTime입니다.
writeToDiagnosticsTrace	선택적 Boolean 특성입니다. 등록된 모든 수신기에서 Trace 메시지를 표시하도록 ASP.NET 추적 메시지를 System.Diagnostics 추적 인프라에 전달할지 여부를 지정합니다. 자세한 내용은 system.diagnostics의 trace 요소를 참조하십시오. 이 특성은 .NET Framework 버전 2.0에서 새로 도입되었습니다. 기본값은 false입니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소입니다.
system.web	구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다.

설명

추적 기능을 사용하면 페이지 출력에 추가되거나 응용 프로그램 추적 로그에 저장될 수 있는 추적 메시지가 페이지 요청마다 생성됩니다. ASP.NET 추적 뷰어(Trace.axd)를 사용하여 추적 로그의 내용을 볼 수 있습니다. 기본적으로 Trace.axd는 httpHandlers 요소에 추가됩니다.

참고

일반적으로 활성 웹 사이트에서 추적을 사용하도록 설정하면 해당 웹 사이트에서 페이지를 보는 모든 사람에게 중요한 구성 정보가 표시될 수 있으므로 이 방법은 사용하지 않는 것이 좋습니다.추적은 디버깅 용도로만 사용해야 합니다.localOnly 특성이 true이면 로컬 호스트 요청에 대해서만 추적 정보가 표시됩니다.또한 Web.config 파일에 <deployment retail=true>를 설정하면 추적이 해제됩니다.

Trace 클래스의 속성 및 메서드를 사용하여 릴리스 빌드를 계측합니다. 계측을 사용하면 실제 설정으로 응용 프로그램을 실행하여 응용 프로그램 상태를 모니터링할 수 있습니다. 추적 기능은 실행 중인 시스템을 중단하지 않고 문제를 격리시킨 후 해결하는 데 도움이 됩니다.

추적을 적용하려면 추적 플래그를 설정한 상태에서 응용 프로그램을 다시 컴파일해야 합니다. 이렇게 하려면 추적을 지원할 언어 컴파일러의 구성 줄에서 compilerOptions 특성을 ="/d:TRACE"로 설정합니다. 자세한 내용은 <compiler> 요소를 참조하십시오.

기본 구성

다음의 기본 trace 요소는 Machine.config 파일 또는 루트 Web.config 파일에 명시적으로 구성되어 있지 않습니다. 그러나 이 요소는 .NET Framework 2.0 이상 버전의 응용 프로그램에서 반환하는 기본 구성입니다.

<trace 
   enabled="false" 
   localOnly="true" 
   mostRecent="false" 
   pageOutput="false" 
   requestLimit="10" 
   traceMode="SortByTime" 
   writeToDiagnosticsTrace="false" 
/>

다음의 기본 trace 요소는 .NET Framework 버전 1.0 및 1.1의 Machine.config 파일에 구성되어 있습니다.

<trace
   enabled="false"
   localOnly="true"
   pageOutput="false"
   requestLimit="10"
   traceMode="SortByTime"
/>

예제

다음 코드 예제에서는 추적 구성 설정을 지정하는 방법을 보여 줍니다.

<configuration>
  <system.web>
    <trace enabled="true" 
      pageOutput="true"
      requestLimit="15"
      mostRecent="true" />
    <system.web>
</configuration>

요소 정보

구성 섹션 처리기	TraceSection
구성 멤버	TraceSection
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0 이상 .NET Framework Microsoft Visual Studio

참고 항목