다음을 통해 공유

데이터 클라이언트 추적

  • 아티클

소비자, 서비스 구성 요소, 공급자, 네트워킹, 호스트 데이터 원본 등에서 문제를 캡처하는 데 도움이 될 수 있는 추적을 위한 여러 옵션이 있습니다.

SQL Server 프로파일러를 사용하는 SQL 소비자 추적

SQL Server 프로파일러는 SQL Trace에서 데이터베이스 엔진 또는 Analysis Services의 인스턴스를 모니터링하기 위한 그래픽 사용자 인터페이스입니다. 각 이벤트에 대한 데이터를 캡처하고 파일이나 테이블에 저장하여 나중에 분석할 수 있습니다. 자세한 내용은 SQL Server Profiler 소개(https://go.microsoft.com/fwlink/?LinkID=180433)를 참조하세요.

공급자 추적 유틸리티를 사용하는 데이터 공급자 추적

HIS 추적 유틸리티는 Microsoft DB2와 Informix 네트워크 클라이언트 연결, 공급자 인터페이스, 데이터 메시지에서 정보를 캡처하고 저장합니다. 자세한 내용은 추적 유틸리티 도움말 및 SNA 추적 유틸리티를 참조하세요.

네트워크 모니터를 사용하는 네트워크 추적

네트워크 모니터는 표시와 분석을 위해 네트워크 트래픽을 캡처합니다. 이를 통해 이전에 캡처한 데이터를 사용자 정의 방식으로 분석하거나 정의된 프로토콜 파서에서 데이터를 추출하는 등의 태스크를 수행할 수 있습니다. HIS 데이터 네크워크 클라이언트와 함께 사용하기 위한 DDM(분산 데이터 관리) 파서가 포함되어 있습니다. DDM 파서의 사본을 구하려면 Microsoft 고객 지원 서비스에 문의하십시오. 자세한 내용은 네트워크 모니터 (https://go.microsoft.com/fwlink/?LinkID=180448)를 참조하세요.

IBM 도구를 사용하는 DB2 서버 추적

자세한 내용은 해당 DB2 플랫폼과 버전에 대한 IBM DB2 관리자 설명서를 참조하십시오.

IBM 도구를 사용하는 Informix 서버 추적

자세한 내용은 해당 Informix 플랫폼과 버전에 대한 IBM Informix 관리자 설명서를 참조하세요.

이벤트 뷰어를 사용하는 Windows Server 이벤트

이벤트 뷰어는 이벤트 로그를 찾아보고 관리하는 데 사용하는 MMC(Microsoft Management Console) 스냅인으로 자세한 내용은 이벤트 뷰어(https://go.microsoft.com/fwlink/?LinkID=131274)를 참조하세요.

호스트 파일 클라이언트 및 데이터 공급자 추적

호스트 파일 클라이언트 및 호스트 파일용 ADO.NET 데이터 공급자(호스트 파일 클라이언트)는 데이터 소비자 app.config 파일의 시스템 진단 요소에서 참조되는 HIDT(Host Integration 추적 정의) 구성 파일을 사용하여 구성되는 Microsoft Host Integration 텍스트 추적 수신기를 지원합니다.

데이터 소비자 App.Config 파일

데이터 소비자 app.config 파일에는 Microsoft Host Integration 추적 구성 섹션 요소와 호스트 파일 클라이언트 추적을 제어하는 Host Integration Server 텍스트 파일 수신기 요소가 포함되어 있습니다. 이 예제에서 MsHostFileClient.HITD(Host Integration 추적 정의) 파일은 데이터 소비자 프로그램 디렉터리에 있어야 합니다.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="microsoft.hostintegration.tracing" type="Microsoft.HostIntegration.Tracing.TraceSection, Microsoft.HostIntegration.Tracing.Configuration, Culture=neutral, Version=9.0.1000.0, PublicKeyToken=31bf3856ad364e35" />
  </configSections>

  <microsoft.hostintegration.tracing
    traceDefinitionFile=" MsHostFileClient.HITD" />

  <system.diagnostics>
    <trace>
      <listeners>
        <add
          name="HisTextFileListener"
          type="Microsoft.HostIntegration.Tracing.HisTextFileTraceListener, Microsoft.HostIntegration.Tracing.Runtime, Culture=neutral, Version=9.0.1000.0, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL"
          maxTraceEntries="1000000"
          traceFileFolder="C:\Program Files\Microsoft Host Integration Server 2020\traces\"
          autoFlush="true"
          fileNamePreamble="MsHostFileClient"
          allowNonHisTracingToCreateFile="true"
    />
      </listeners>
    </trace>
  </system.diagnostics>
  <startup>
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup>
</configuration>

구성 섹션

configSections 요소에는 Microsoft Host Integration 추적 구성 요소의 구성 섹션과 네임스페이스 선언이 포함되어 있습니다.

구성 섹션 이름

섹션 name 특성은 Microsoft Host Integration 추적 구성 요소의 이름을 정의합니다. 이 필수 특성은 Microsoft.hostintegration.tracing 값을 포함하는 문자열을 허용합니다.

구성 섹션 유형

type 특성은 Microsoft Host Integration 추적 텍스트 추적 수신기의 유형을 정의합니다. 이 필수 특성은 Microsoft.HostIntegration.Tracing.TraceSection, Microsoft.HostIntegration.Tracing.Configuration, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35 값을 포함하는 문자열을 허용합니다.

Host Integration 추적 섹션

microsoft.hostintegration.tracing 요소는 Microsoft Host Integration 추적 구성 요소 텍스트 추적 수신기의 구성 정보를 포함합니다.

추적 정의 파일

traceDefinitionFile 특성은 Microsoft Host Integration 추적 텍스트 추적 수신기 출력 파일의 이름을 정의합니다. 이 필수 특성은 추적 출력 경로 및 파일 이름을 나타내는 값을 포함하는 문자열을 허용합니다.

참고

각 사용자 계정은 텍스트 추적 파일에 줄을 삽입하기 위해 추적 폴더에 대한 쓰기 권한이 있어야 합니다. 각 사용자 계정은 폴더 액세스 제어 목록 설정을 HIS 런타임 사용자 로컬 그룹과 연결해야 합니다. 자세한 내용은 보안 및 보호 섹션을 참조하세요.

시스템 진단

system.diagnostics 요소는 Microsoft Host Integration 추적 구성 요소 텍스트 추적 수신기의 추가 구성을 포함합니다.

추적 수신기 이름

name 특성은 호스트 파일 클라이언트 텍스트 추적 수신기의 이름을 정의합니다. 이 필수 특성은 HisTextFileListener 값을 포함하는 문자열을 허용합니다.

추적 수신기 유형

type 특성은 DRDA 서비스 텍스트 추적 수신기의 유형을 정의합니다. 이 필수 특성은 Microsoft.HostIntegration.Tracing.HisTextFileTraceListener, Microsoft.HostIntegration.Tracing.Runtime, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL 값을 포함하는 문자열을 허용합니다.

최대 추적 항목 수

maxTraceEntries 특성은 최대 항목 수까지 추적한 다음에 추적을 중지하도록 호스트 파일 클라이언트에 지시합니다. 이 선택적 특성은 정수를 허용합니다. 기본값은 1000000입니다.

추적 파일 폴더

traceFileFolder 특성은 호스트 파일 클라이언트 텍스트 추적 수신기에 텍스트 수신기 추적 출력 파일을 쓸 위치를 지시합니다. 이 선택적 특성은 문자열 값을 허용합니다. 기본값은 C:\Program Files\Microsoft Host Integration Server 2013\traces입니다.

참고

각 사용자 계정은 텍스트 추적 파일에 줄을 삽입하기 위해 추적 폴더에 대한 쓰기 권한이 있어야 합니다. 각 사용자 계정은 폴더 액세스 제어 목록 설정을 HIS 런타임 사용자 로컬 그룹과 연결해야 합니다. 자세한 내용은 보안 및 보호 섹션을 참조하세요.

자동 플러시

autoFlush 특성은 추적 수신기에 데이터를 자동으로 플러시하도록 DRDA 서비스에 지시합니다. 이 선택적 특성은 부울 값을 허용합니다. 기본값은 false입니다.

참고

호스트 파일 클라이언트 텍스트 추적 수신기는 추적 데이터를 추적 수신기에 자동으로 플러시할 수 있습니다. 이 경우 추적 데이터는 캡처되지만 디스크 I/O가 늘어나고 전체 시스템 성능이 저하됩니다. 성능을 향상하려면 autoFlush=false를 설정하여 자동 추적 플러시를 사용하지 않도록 설정합니다.

추적 파일 이름

name 특성은 호스트 파일 클라이언트 텍스트 추적 출력 파일의 이름을 정의합니다. 이 필수 특성은 문자열을 허용합니다.

추적 수신기 초기화

allowNonHisTracingToCreateFile 특성은 호스트 파일 클라이언트 및 Microsoft Host Integration 추적 이외의 구성 요소에서 추적을 시작할 수 있는지 여부를 정의합니다. 이 필수 특성은 부울을 허용하며 기본값은 false입니다.

HITD(Host Integration 추적 정의) 파일

HIDT(Host Integration 추적 정의) 구성 파일은 Host Integration Server 텍스트 파일 수신기의 추적 수준을 정의합니다.

추적 컨테이너

containers 요소는 각 추적 지점의 추적 수준을 정의하는 컨테이너 요소를 포함합니다.

추적 컨테이너 이름

name 특성은 추적 컨테이너의 이름을 정의합니다. 이 필수 특성은 HostFiles 값을 포함하는 문자열을 허용합니다.

추적 지점 이름

name 특성은 추적 원본 지점의 이름을 정의합니다. 이 필수 특성은 문자열을 허용합니다. 기본값은 빈 문자열입니다.

값 Description
HostFiles 호스트 파일용 ADO.NET 공급자
전송 DDM RLIO용 호스트 파일 클라이언트
Aggregate Converter Host Integration Server 인코더 집계 변환기
Primitive Converter Host Integration Server 인코더 기본 변환기

표 1. 호스트 파일 추적 원본 지점 이름

추적 수준

traceLevel 특성은 최소에서 최대 추적 수준까지 정의된 정보 모음을 추적하도록 호스트 파일 클라이언트에 지시합니다. 이 선택적 특성은 문자열 값을 허용합니다. 기본값은 빈 문자열입니다.

값 Description
Fatal 치명적인 메시지를 출력합니다.
Error 오류 메시지를 출력합니다.
Warning 경고 메시지, 오류 메시지, 치명적인 메시지를 출력합니다.
정보 산업 정보 메시지, 경고 메시지, 오류 메시지, 치명적인 메시지를 출력합니다.
자세히 모든 메시지를 출력합니다.
데이터 모든 메시지 및 사용자 데이터를 출력합니다.
디버그 모든 메시지, 사용자 데이터, 디버그 데이터를 출력합니다.

표 2. 호스트 파일 텍스트 추적 수신기 수준

<containers>
  <container name="HostFiles">
    <tracePoint name="MsHostFileClient">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Transport">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Aggregate Converter">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Primitive Converter">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
  </container>
</containers>

참고 항목

Data Integration (Troubleshooting)(데이터 통합(문제 해결))