SQL 어댑터의 진단 추적 및 메시지 로깅

아티클
07/21/2023

진단 추적은 어댑터를 사용할 때 발생할 수 있는 문제를 효과적으로 진단하는 데 도움이 됩니다. 어댑터 클라이언트는 다음 두 수준에서 진단 추적을 활성화할 수 있습니다.

어댑터 클라이언트와 어댑터 간
어댑터 내

이 섹션에서는 이러한 수준에서 추적을 활성화하는 방법에 대한 정보를 제공합니다.

어댑터 클라이언트와 어댑터 간 추적

어댑터 클라이언트는 WCF 추적을 사용하여 어댑터 클라이언트와 어댑터 간의 문제를 추적할 수 있습니다. WCF 추적은 WCF 서비스 모델을 사용하여 어댑터 클라이언트에서 가져온 입력 XML을 추적하는 데 사용되며 직렬화 문제를 진단하는 데 유용합니다. WCF 추적은 WCF 채널 모델이나 어댑터에서 어댑터 클라이언트로의 출력 메시지에 사용되지 않습니다. 각 구성 파일에 발췌를 추가하여 BizTalk 애플리케이션 및 WCF 서비스 모델 애플리케이션에 대한 WCF 추적을 활성화할 수 있습니다. 또한 디자인 타임과 런타임에 모두 추적을 사용하도록 설정할 수 있습니다.

디자인 타임에 추적. 디자인 타임 환경의 경우 어댑터 서비스 참조 플러그 인 추가, 어댑터 서비스 추가 기능 사용 또는 어댑터 메타데이터 추가 마법사를 사용할 수 있습니다. 이러한 모든 도구는 Visual Studio에서 사용할 수 있습니다. 따라서 디자인 타임 환경에 대한 추적을 사용하도록 설정하려면 설치 드라이브>:\Program Files\Microsoft Visual Studio version\Common7\IDE에< 있는 devenv.exe.config 파일에 발췌를 추가해야 합니다.><
런타임에 추적. 런타임 추적의 경우 사용 중인 애플리케이션에 따라 발췌를 추가해야 합니다.
- BizTalk Server 애플리케이션의 경우 일반적으로 BTSNTSvc.exe.config BizTalk 구성 파일에 발췌를 추가해야 합니다. BizTalk Server 경우 이 파일은 일반적으로 설치 드라이브>:\Program Files\Microsoft BizTalk Server 사용할 <수 있습니다.
- WCF 서비스 모델 .NET 애플리케이션의 경우 발췌한 내용을 프로젝트의 app.config 파일에 추가해야 합니다.
WCF 추적을 사용하도록 설정하려면 태그 내에 다음 발췌를 추가합니다 <configuration> .

<system.diagnostics>  
    <sources>  
      <source name ="System.ServiceModel" switchValue="Verbose">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name ="System.ServiceModel.MessageLogging"   
              switchValue="Verbose, ActivityTracing">          
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name ="System.Runtime.Serialization" switchValue="Verbose">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
   </sources>  
   <sharedListeners>  
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener"                
           traceOutputOptions="LogicalOperationStack"   
           initializeData="C:\log\WCFTrace.svclog" />  
   </sharedListeners>  
   <trace autoflush="true" />  
  </system.diagnostics>  
  <system.serviceModel>  
    <diagnostics>  
      <messageLogging   
           logEntireMessage="true"   
           logMalformedMessages="false"  
           logMessagesAtServiceLevel="true"   
           logMessagesAtTransportLevel="false"/>  
    </diagnostics>      
  </system.serviceModel>

이렇게 하면 WCF 추적이 C:\log\WCFTrace.svclog에 저장됩니다. WCF 추적에 대한 자세한 내용은 추적을 참조하세요.

중요

추적을 사용하도록 설정하여 중요한 비즈니스 데이터를 노출하는 잠재적인 보안 위협을 완화해야 합니다. 권장 사항은 SQL 어댑터 보안 모범 사례를 참조하세요.

어댑터 내 추적

어댑터는 오류, 경고 및 정보 메시지와 같은 다양한 범주의 유용한 정보를 추적 파일에 기록합니다. 이러한 정보는 어댑터 내의 프로세스 흐름을 이해하고 어댑터 관련 문제를 진단하는 데 유용합니다. 각 구성 파일에 발췌를 추가하여 BizTalk 애플리케이션 및 WCF 서비스 모델 애플리케이션에 대한 WCF LOB 어댑터 SDK 및 어댑터 추적을 활성화할 수 있습니다. 또한 디자인 타임과 런타임에 모두 추적을 사용하도록 설정할 수 있습니다.

디자인 타임에 추적. 디자인 타임 환경의 경우 어댑터 서비스 참조 플러그 인 추가, 어댑터 서비스 추가 기능 사용 또는 어댑터 메타데이터 추가 마법사를 사용할 수 있습니다. 이러한 모든 도구는 Visual Studio에서 사용할 수 있습니다. 따라서 디자인 타임 환경에 대한 추적을 사용하도록 설정하려면 설치 드라이브>:\Program Files\Microsoft Visual Studio version\Common7\IDE에< 있는 devenv.exe.config 파일에 발췌를 추가해야 합니다.><
런타임에 추적. 런타임 추적의 경우 사용 중인 애플리케이션에 따라 발췌를 추가해야 합니다.
- BizTalk Server 애플리케이션의 경우 일반적으로 BTSNTSvc.exe.config BizTalk 구성 파일에 발췌를 추가해야 합니다. BizTalk Server 경우 이 파일은 일반적으로 설치 드라이브>:\Program Files\Microsoft BizTalk Server 사용할 <수 있습니다.
- WCF 서비스 모델 .NET 애플리케이션의 경우 발췌한 내용을 프로젝트의 app.config 파일에 추가해야 합니다.
WCF LOB 어댑터 SDK 및 어댑터 추적을 사용하도록 설정하려면 태그 내에 다음 발췌를 <configuration> 추가합니다.

<system.diagnostics>  
    <sources>  
      <source name="Microsoft.ServiceModel.Channels" switchValue="Error">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name="Microsoft.Adapters.Sql" switchValue="Information">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener"   
   traceOutputOptions="LogicalOperationStack"   
          initializeData="C:\log\AdapterTrace.svclog" />  
    </sharedListeners>  
    <trace autoflush="true" />  
  </system.diagnostics>

이렇게 하면 WCF 추적이 C:\log\AdapterTrace.svclog에 저장됩니다.

추적 보기

WCF(Windows Communication Foundation) 서비스 추적 뷰어 도구를 사용하여 추적을 볼 수 있습니다. 도구에 대한 자세한 내용은 상호 관련된 추적 및 문제 보기를 위해 서비스 추적 뷰어 사용을 참조하세요.

BizTalk 애플리케이션에 대한 추적 구성

BizTalk Server 관리 콘솔을 사용하면 송신 포트 및 수신 포트와 같은 항목에 대한 다양한 추적 옵션을 구성할 수 있습니다. 추적 구성 설정을 사용하면 인바운드 및 아웃바운드 이벤트 데이터, 메시지 속성, 메시지 본문 및 오케스트레이션을 추적할 수 있습니다. BizTalk 애플리케이션에 대한 추적을 구성하는 방법에 대한 자세한 내용은 아티팩트 관리를 참조하세요.

HAT(상태 및 활동 추적)을 사용하여 기록 또는 추적된 데이터를 볼 수도 있습니다. 자세한 내용은 기록 및 추적된 데이터 보기를 참조하세요.

참고 항목

SQL 어댑터 문제 해결

다음을 통해 공유