추적 구성

이 항목에서는 추적을 사용하고, 추적을 내보내도록 추적 소스를 구성하고, 추적 수준을 설정하고, 종단 간 추적 상관 관계를 지원하도록 동작 추적 및 전파를 설정하고, 추적에 액세스하도록 추적 수신기를 설정하는 방법에 대해 설명합니다.

프로덕션 또는 디버깅 환경에서 권장되는 추적 설정에 대한 자세한 내용은 추적 및 메시지 로깅에 권장되는 설정을 참조하십시오.

추적 사용

WCF(Windows Communication Foundation)에서는 진단 추적을 위해 다음 데이터를 출력합니다.

• 작업 호출, 코드 예외, 경고 및 기타 중요 처리 이벤트 등과 같이 응용 프로그램의 모든 구성 요소에서 프로세스 중요 시점에 대한 추적
• 추적 기능 오작동 시 Windows 오류 이벤트. 이벤트 로깅을 참조하십시오.

WCF 추적은 System.Diagnostics를 기반으로 합니다. 추적을 사용하려면 구성 파일이나 코드에 추적 소스를 정의해야 합니다. WCF는 WCF 어셈블리마다 추적 소스를 정의합니다. System.ServiceModel 추적 소스는 가장 일반적인 WCF 추적 소스이며, 전송 시작/종료에서 사용자 코드 시작/종료까지 WCF 통신 스택의 처리 중요 시점을 기록합니다. System.ServiceModel.MessageLogging 추적 소스는 시스템을 통해 이동하는 모든 메시지를 기록합니다.

추적은 기본적으로 사용되지 않습니다. 추적을 활성화하려면 추적 수신기를 만들고 구성에서 선택한 추적 소스에 대해 "Off" 이외의 추적 수준을 설정해야 합니다. 그렇지 않으면, WCF가 추적을 생성하지 않습니다. 수신기를 지정하지 않으면 추적이 자동으로 사용되지 않습니다. 수신기는 정의되었지만 수준이 지정되지 않은 경우 수준이 기본적으로 "Off"로 설정됩니다. 이 설정은 추적이 내보내지지 않음을 의미합니다.

응용 프로그램의 구성 파일(웹 호스팅 응용 프로그램의 경우 Web.config, 자체 호스팅된 응용 프로그램의 경우 Appname.exe.config)을 사용하여 추적을 구성할 수 있습니다. 예를 들면 다음과 같습니다.

<configuration>
   <system.diagnostics>
      <sources>
            <source name="System.ServiceModel" 
                    switchValue="Information, ActivityTracing"
                    propagateActivity="true">
            <listeners>
               <add name="traceListener" 
                   type="System.Diagnostics.XmlWriterTraceListener" 
                   initializeData= "c:\log\Traces.svclog" />
            </listeners>
         </source>
      </sources>
   </system.diagnostics>
</configuration>

추적을 내보내도록 추적 소스 구성

WCF는 각 어셈블리에 대한 추적 소스를 정의합니다. 어셈블리 내에 생성된 추적은 해당 소스에 대해 정의된 수신기를 통해 액세스합니다. 다음 추적 소스가 정의됩니다.

• System.ServiceModel: 구성을 읽을 때마다, 메시지가 전송, 보안 처리에서 처리될 때마다, 메시지가 사용자 코드에서 디스패치될 때마다 모든 WCF 처리 단계를 기록합니다.
• System.ServiceModel.MessageLogging: 시스템을 통해 이동하는 모든 메시지를 기록합니다.
• System.IdentityModel
• System.ServiceModel.Activation
• System.IO.Log: CLFS(Common Log File System)에 대한 .NET Framework 인터페이스에 대해 기록합니다.
• System.Runtime.Serialization: 개체를 읽거나 쓸 때 기록됩니다.
• CardSpace

다음 구성 예제에 표시된 대로 같은(공유) 수신기를 사용하도록 각 추적 소스를 구성할 수 있습니다.

<configuration>
    <system.diagnostics>
        <sources>
            <source name="System.ServiceModel" 
                    switchValue="Information, ActivityTracing"
                    propagateActivity="true">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
            <source name="CardSpace">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
            <source name="System.IO.Log">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
            <source name="System.Runtime.Serialization">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
            <source name="System.IdentityModel">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
        </sources>

        <sharedListeners>
            <add name="xml"
                 type="System.Diagnostics.XmlWriterTraceListener"
                 initializeData="c:\log\Traces.svclog" />
        </sharedListeners>
    </system.diagnostics>
</configuration>

또한, 다음 예제처럼 사용자 정의 추적 소스를 추가하여 사용자 코드 추적을 내보낼 수 있습니다.

<system.diagnostics>
   <sources>
       <source name="UserTraceSource" switchValue="Warning, ActivityTracing" >
          <listeners>
              <add name="xml"
                 type="System.Diagnostics.XmlWriterTraceListener"
                 initializeData="C:\logs\UserTraces.svclog" />
          </listeners>
       </source>
   </sources>
   <trace autoflush="true" /> 
</system.diagnostics>

사용자 정의 추적 소스 생성에 대한 자세한 내용은 Extending Tracing을 참조하십시오.

추적을 사용하도록 추적 수신기 구성

런타임에 WCF는 데이터를 처리하는 수신기로 추적 데이터를 공급합니다. WCF는 System.Diagnostics에 대해 미리 정의된 여러 수신기를 제공하며, 이들은 출력에 사용하는 형식이 다릅니다. 사용자 지정 수신기 형식을 추가할 수도 있습니다.

add를 사용하여 사용할 추적 수신기의 이름과 형식을 지정할 수 있습니다. 예제 구성에서는 수신기 이름을 traceListener로 지정하고 표준 .NET Framework 추적 수신기(System.Diagnostics.XmlWriterTraceListener)를 사용할 형식으로 추가했습니다. 각 소스에 대한 추적 수신기를 여러 개 추가할 수 있습니다. 추적 수신기가 파일로 추적을 내보내는 경우에는 구성 파일에 출력 파일 위치와 이름을 지정해야 합니다. 이 작업을 수행하려면 initializeData를 해당 수신기의 파일 이름으로 설정합니다. 파일 이름을 지정하지 않으면 사용된 수신기 형식에 따라 임의 파일 이름이 생성됩니다. XmlWriterTraceListener가 사용되면 확장명이 없는 파일 이름이 생성됩니다. 사용자 지정 수신기를 구현하는 경우 이 특성을 사용하여 파일 이름 이외의 초기화 데이터를 받을 수도 있습니다. 예를 들면 이 특성에 대한 데이터베이스 식별자를 지정할 수 있습니다.

원격 데이터베이스와 같은 연결을 통해 추적을 보내도록 사용자 지정 추적 수신기를 구성할 수 있습니다. 응용 프로그램 배포자인 경우 원격 컴퓨터의 추적 로그에 적절한 액세스 제어를 적용해야 합니다.

추적 수신기를 프로그래밍 방식으로 구성할 수도 있습니다. 자세한 내용은 방법: 추적 수신기 만들기 및 초기화(영문 페이지일 수 있음) 및 사용자 지정 TraceListener 만들기(영문 페이지일 수 있음)를 참조하십시오.

추적 수준

추적 수준은 추적 소스의 switchValue 설정에 의해 제어됩니다. 다음 표에서는 사용할 수 있는 추적 수준에 대해 설명합니다.

Verbose에서 Critical까지의 수준은 서로 위에 쌓입니다. 즉, 각 추적 수준에 Off 수준을 제외한 위의 모든 수준이 포함됩니다. 예를 들어, Warning 수준에서 수신 대기하는 수신기는 Critical, Error 및 Warning 추적을 수신합니다. 모두 수준에는 Verbose에서 Critical까지의 이벤트와 동작 추적 이벤트가 포함됩니다.

상관 관계를 위한 동작 추적 및 전파 구성

switchValue 특성에 대한 지정된 activityTracing 값은 끝점 내에서 동작 경계와 전송에 대한 추적을 내보내는 동작 추적을 활성화하는 데 사용됩니다.

propagateActivity 특성은 동작을 메시지 교환에 참여하는 다른 끝점에 전파해야 하는지 여부를 나타냅니다. 이 값을 true로 설정하여 두 끝점에서 생성된 추적 파일을 가져오고 한 끝점의 추적 집합이 다른 끝점의 추적 집합으로 이동한 방법을 확인할 수 있습니다.

동작 추적 및 전파에 대한 자세한 내용은 종단 간 추적 상관 관계를 위한 동작 추적 및 전파를 참조하십시오.

propagateActivity 및 ActivityTracing 부울 값 모두 System.ServiceModel TraceSource에 적용됩니다. ActivityTracing 값도 WCF 또는 사용자 정의 추적 소스를 비롯하여 모든 추적 소스에 적용됩니다.

propagateActivity 특성은 사용자 정의 추적 소스에 사용할 수 없습니다. 사용자 코드 동작 ID 전파를 위해 ServiceModel ActivityTracing은 설정하지 않고 ServiceModel propagateActivity 특성은 true로 설정해야 합니다.

참고 항목

개념

관리 및 진단

기타 리소스

추적
방법: 추적 수신기 만들기 및 초기화(영문 페이지일 수 있음)
사용자 지정 TraceListener 만들기(영문 페이지일 수 있음)