Share via

추적 및 메시지 로깅

  • 아티클

TracingAndLogging 샘플에서는 추적 및 메시지 로깅을 사용하도록 설정하는 방법을 보여 줍니다. 결과 추적 및 메시지 로그는 서비스 추적 뷰어 도구(SvcTraceViewer.exe)를 사용하여 볼 수 있습니다. 이 샘플은 시작을 기준으로 합니다.

참고 항목

이 샘플의 설치 절차 및 빌드 지침은 이 항목의 끝부분에 나와 있습니다.

추적

WCF(Windows Communication Foundation)는 System.Diagnostics 네임스페이스에 정의된 추적 메커니즘을 사용합니다. 이 추적 모델에서 추적 데이터는 애플리케이션이 구현하는 추적 소스에 의해 생성됩니다. 각 소스는 이름으로 식별됩니다. 추적 소비자는 정보를 검색하려는 추적 소스에 대한 추적 수신기를 만듭니다. 추적 데이터를 수신하려면 추적 소스에 대한 수신기를 만들어야 합니다. WCF에서 서비스 모델 추적 원본 switchValue을(를) 설정하고 서비스 또는 클라이언트의 구성 파일에 다음 코드를 추가하여 이 작업을 수행할 수 있습니다.

<system.diagnostics>
    <sources>
      <source name="System.ServiceModel" switchValue="Information,ActivityTracing"
        propagateActivity="true">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name="System.ServiceModel.MessageLogging">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add initializeData="C:\logs\TracingAndLogging-service.svclog" type="System.Diagnostics.XmlWriterTraceListener"
        name="xml" />
    </sharedListeners>
    <trace autoflush="true" />
</system.diagnostics>

추적 원본에 대한 자세한 내용은 추적 구성 항목의 추적 원본 단원을 참조하세요.

동작 추적 및 전파

클라이언트 및 서비스 모두에 대해 system.ServiceModel 추적 원본에서 ActivityTracing을 사용하도록 설정하고 propagateActivity를 true로 설정하면 처리의 논리 단위 내에서(동작), 엔드포인트 내의 동작 사이에서(동작 전송을 통해), 그리고 여러 엔드포인트에 걸쳐 있는 동작 사이에서(동작 ID 전파를 통해) 추적의 상관 관계가 제공됩니다.

이러한 세 가지 메커니즘(동작, 전송 및 전파)은 Service Trace Viewer 도구를 사용하여 오류의 근본 원인을 더 신속하게 찾을 수 있도록 도와줍니다. 자세한 내용은 Service Trace Viewer를 사용하여 상호 관련된 추적 보기 및 문제 해결을 참조하세요.

사용자 정의 동작 추적을 만들어 ServiceModel이 제공되는 추적을 확장할 수 있습니다. 사용자 정의 동작 추적을 통해 사용자는 추적 동작을 만들어 다음을 수행할 수 있습니다.

  • 추적을 작업의 논리 단위로 그룹화합니다.

  • 전송과 전파를 통해 동작을 상호 연결합니다.

  • WCF 추적의 성능 비용(예: 로그 파일의 디스크 공간 비용)을 줄입니다.

사용자 정의 동작 추적에 대한 자세한 내용은 추적 확장 샘플을 참조하세요.

메시지 로깅

모든 WCF 애플리케이션의 클라이언트 및 서비스 둘 다에서 메시지 로깅을 사용하도록 설정할 수 있습니다. 메시지 로깅을 사용하도록 설정하려면 클라이언트나 서비스에 다음 코드를 추가해야 합니다.

<configuration>
  <system.serviceModel>
    <diagnostics>
      <!-- Enable Message Logging here. -->
      <!-- log all messages received or sent at the transport or service model levels -->
      <messageLogging logEntireMessage="true"
                      maxMessagesToLog="300"
                      logMessagesAtServiceLevel="true"
                      logMalformedMessages="true"
                      logMessagesAtTransportLevel="true" />
    </diagnostics>
  </system.serviceModel>
</configuration>

메시지가 기록될 때 클라이언트에서 추적되는지 아니면 서버에서 추적되는지 여부에 따라 추적 유형이 달라집니다. 예를 들어, 클라이언트에 보내지는 "추가" 메시지는 클라이언트에서는 "TransportWrite" 범주 아래에 추적되지만 서비스에서는 "TransportRead" 범주 아래에 추적됩니다.

클라이언트의 App.config 파일이나 서비스의 Web.config 파일의 System.Diagnostics 섹션에 다음 코드를 추가하여 추적 수신기를 구성합니다.

<system.diagnostics>
    <sources>
      <source name="System.ServiceModel" switchValue="Information,ActivityTracing"
        propagateActivity="true">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name="System.ServiceModel.MessageLogging">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add initializeData="C:\logs\TracingAndLogging-client.svclog" type="System.Diagnostics.XmlWriterTraceListener"
        name="xml" />
    </sharedListeners>
    <trace autoflush="true" />
  </system.diagnostics>

메시지는 구성 파일에 지정된 대상 디렉터리에 XML 형식으로 기록됩니다.

참고 항목

처음에 로그 디렉터리를 만들어야 추적 파일이 만들어집니다. C:\logs\ 디렉터리가 있는지 확인하거나 수신기 구성에서 대체 로깅 디렉터리를 지정합니다. 자세한 내용은 이 문서의 끝에 있는 초기 설정 지침을 참조하십시오.

메시지 로깅에 대한 자세한 내용은 메시지 로깅 구성 항목을 참조하세요.

샘플을 설치, 빌드 및 실행하려면

  1. Windows Communication Foundation 샘플의 일회 설치 절차를 수행했는지 확인합니다.

  2. Tracing and Message Logging 샘플을 실행하기 전에 .svclog 파일을 서비스에서 기록할 수 있도록 C:\logs\ 디렉터리를 만듭니다. 이 디렉터리의 이름은 추적 및 메시지를 기록하기 위한 경로로 구성 파일에 정의되며 변경할 수 있습니다. 로그 디렉터리에 대한 Network Service 쓰기 권한을 사용자에게 제공합니다.

  3. C#, C++ 또는 Visual Basic .NET 버전의 솔루션을 빌드하려면 Windows Communication Foundation 샘플 빌드의 지침을 따릅니다.

  4. 단일 컴퓨터 또는 다중 컴퓨터 구성에서 샘플을 실행하려면 Windows Communication Foundation 샘플 실행의 지침을 따릅니다.

참고 항목