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

아티클
07/21/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 추적에 대한 자세한 내용은 추적을 참조하세요.

중요

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

어댑터 내 추적

어댑터는 오류, 경고 및 정보 메시지와 같은 다양한 범주의 유용한 정보를 추적 파일에 기록합니다. 이러한 정보는 어댑터 내의 프로세스 흐름을 이해하고 어댑터 관련 문제를 진단하는 데 유용합니다. 각 구성 파일에 발췌를 추가하여 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.SAP" 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 추적(클라이언트/서버 쪽)에 의존하여 이 정보에 액세스합니다. SAP 어댑터를 사용하면 연결 URI에서 "RfcSdkTrace" 매개 변수를 지정하여 어댑터 클라이언트가 SAP 시스템 내에서 추적을 켤 수 있습니다. RFC SDK가 SAP 시스템 내에서 정보 흐름을 추적할 수 있도록 하려면 이 매개 변수를 지정해야 합니다. 연결 URI에 대한 자세한 내용은 SAP 시스템 연결 URI 만들기를 참조하세요.

또한 RFC SDK에 대한 추적 수준을 설정하는 RFC_TRACE 환경 변수를 만들 수도 있습니다. RFC_TRACE SAP에서 정의한 환경 변수이며 RFC SDK에서 사용됩니다. 이 변수가 정의되지 않았거나 0으로 설정된 경우 RFC SDK 추적 수준은 최소한입니다. 변수가 1 또는 2로 설정된 경우 추적 수준이 더 상세합니다.

참고

RFC_TRACE 환경 변수가 설정되었는지 여부에 관계없이 연결 URI에서 "RfcSdkTrace" 매개 변수가 true로 설정된 경우에만 RFC SDK 추적이 사용하도록 설정됩니다. 이 환경 변수의 값은 RFC SDK 추적 수준만 제어합니다. RfcSdkTrace가 true로 설정된 경우 어댑터와 SAP 시스템 간의 메시지 추적이 컴퓨터의 "system32" 폴더에 복사됩니다. RFC SDK 추적을 다른 위치에 저장하려면 RFC_TRACE_DIR 환경 변수를 설정할 수 있습니다. 이러한 환경 변수에 대한 자세한 내용은 SAP 설명서를 참조하세요.

추적 보기

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

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

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

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

참고 항목

SAP 어댑터 문제 해결

다음을 통해 공유