trace 요소(ASP.NET 설정 스키마)
추적 결과를 수집, 저장 및 표시하는 방법을 제어하는 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 요소에 추가됩니다.
.gif "참고") 참고 |
|---|
일반적으로 활성 웹 사이트에서 추적을 사용하도록 설정하면 해당 웹 사이트에서 페이지를 보는 모든 사람에게 중요한 구성 정보가 표시될 수 있으므로 이 방법은 사용하지 않는 것이 좋습니다.추적은 디버깅 용도로만 사용해야 합니다.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>
요소 정보
구성 섹션 처리기 |
|
구성 멤버 |
|
구성 가능한 위치 |
Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config |
요구 사항 |
Microsoft IIS(인터넷 정보 서비스) 버전 5.0 이상 .NET Framework Microsoft Visual Studio |