Siebel 어댑터에 대한 진단 추적 및 메시지 로깅

아티클
10/14/2023

어댑터 클라이언트는 진단 추적을 사용하여 어댑터를 사용하는 동안 발생한 문제를 효과적으로 진단할 수 있습니다. 어댑터 클라이언트는 세 가지 수준에서 추적을 활성화할 수 있습니다.

어댑터 클라이언트와 어댑터 간
어댑터 내
어댑터와 LOB(기간 업무) 애플리케이션 간

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

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

어댑터 클라이언트는 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 추적은 자세한 정보를 제공합니다.

중요

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

어댑터 내 추적

BizTalk 어댑터 팩의 어댑터는 다양한 범주의 유용한 정보를 오류, 경고 및 정보와 같은 추적 파일에 기록합니다. 이러한 정보는 어댑터 내의 프로세스 흐름을 이해하고 어댑터 문제를 진단하는 데 유용합니다. 각 구성 파일에 발췌를 추가하여 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.Siebel" 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에 저장됩니다.

어댑터와 LOB 애플리케이션 간 추적

LOB 애플리케이션 내에서 의심되는 문제를 진단하려면 어댑터와 LOB 애플리케이션 간의 통신을 위해 추적을 사용하도록 설정해야 합니다. 또한 어댑터는 LOB 추적(클라이언트/서버 쪽)에 따라 이 정보에 액세스할 수 있습니다. LOB 추적 설정의 세부 사항은 이 문서에서 제외됩니다.

또한 Siebel 어댑터는 바인딩 속성(LogData)을 제공하며, True 로 설정하면 추적 수준이 Verbose로 설정되면 Siebel 어댑터는 어댑터와 Siebel 시스템 간의 정보 흐름을 기록합니다. 이 정보는 동일한 추적 파일의 어댑터 추적과 함께 기록됩니다.

이 바인딩 속성에 대한 자세한 내용은 Siebel 바인딩 속성에 대한 BizTalk 어댑터에 대한 읽기를 참조하세요.

추적 보기

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

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

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

그룹 허브를 사용하여 추적 검사 목록 및 모범 사례를 포함하여 추적된 메시지 및 인스턴스 데이터를 볼 수도 있습니다.

참고 항목

Siebel 어댑터 문제 해결

다음을 통해 공유