ETW 추적

아티클
06/08/2023

AnalyticTrace 샘플에서는 ETW(Windows용 이벤트 추적) 및 이 샘플과 함께 제공된 ETWTraceListener를 사용하여 E2E(엔드투엔드) 추적을 구현하는 방법을 보여 줍니다. 이 샘플은 시작을 기반으로 하며 ETW 추적을 포함합니다.

참고 항목

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

이 샘플에서는 추적 및 메시지 로깅에 익숙하다고 가정합니다.

System.Diagnostics 추적 모델의 추적 소스마다 데이터가 추적되는 위치와 방법을 결정하는 추적 수신기가 여러 개씩 있을 수 있습니다. 수신기의 형식에 따라 추적 데이터가 기록되는 형식이 정의됩니다. 다음 코드 샘플에서는 수신기를 구성에 추가하는 방법을 보여 줍니다.

<system.diagnostics>
    <sources>
        <source name="System.ServiceModel"
             switchValue="Verbose,ActivityTracing"
             propagateActivity="true">
            <listeners>
                <add type=
                   "System.Diagnostics.DefaultTraceListener"
                   name="Default">
                   <filter type="" />
                </add>
                <add name="ETW">
                    <filter type="" />
                </add>
            </listeners>
        </source>
    </sources>
    <sharedListeners>
        <add type=
            "Microsoft.ServiceModel.Samples.EtwTraceListener, ETWTraceListener"
            name="ETW" traceOutputOptions="Timestamp">
            <filter type="" />
       </add>
    </sharedListeners>
</system.diagnostics>

이 수신기를 사용하기 전에 ETW 추적 세션이 시작되어야 합니다. 이 세션은 Logman.exe 또는 Tracelog.exe를 사용하여 시작할 수 있습니다. SetupETW.bat 파일이 이 샘플에 포함되어 있으므로 ETW 추적 세션을 닫고 로그 파일을 완료하는 CleanupETW.bat 파일과 함께 세션을 설정할 수 있습니다.

참고 항목

이 샘플의 설치 절차 및 빌드 지침은 이 항목의 끝부분에 나와 있습니다. 이러한 도구에 대한 자세한 내용은 https://go.microsoft.com/fwlink/?LinkId=56580을 참조하세요.

ETWTraceListener를 사용할 경우 추적은 이진 .etl 파일에 기록됩니다. ServiceModel 추적이 설정된 상태에서 생성된 모든 추적은 동일한 파일에 표시됩니다. .etl 및 .svclog 로그 파일을 보려면 서비스 추적 뷰어 도구(SvcTraceViewer.exe)를 사용합니다. 이 뷰어는 해당 소스에서 해당 대상 및 소비 지점까지 메시지를 추적하는 데 사용할 수 있는 시스템의 엔드투엔드 보기를 만듭니다.

ETW 추적 수신기는 순환 로깅을 지원합니다. 이 기능을 사용하도록 설정하려면 시작, 실행으로 차례로 이동한 다음 cmd를 입력하여 콘솔을 시작합니다. 다음 명령에서 <logfilename> 매개 변수를 로그 파일의 이름으로 바꿉니다.

logman create trace Wcf -o <logfilename> -p "{411a0819-c24b-428c-83e2-26b41091702e}" -f bincirc -max 1000

-f 및 -max 스위치는 선택 사항입니다. 이러한 스위치는 각각 이진 순환 형식과 1000MB의 최대 로그 크기를 지정합니다. -p 스위치는 추적 공급자를 지정하는 데 사용됩니다. 위 예제에서 "{411a0819-c24b-428c-83e2-26b41091702e}"는 "XML ETW 샘플 공급자"의 GUID입니다.

세션을 시작하려면 다음 명령을 입력합니다.

logman start Wcf

로깅을 완료한 후 다음 명령을 사용하여 세션을 중지할 수 있습니다.

logman stop Wcf

이 프로세스에서는 서비스 추적 뷰어 도구(SvcTraceViewer.exe) 또는 Tracerpt를 비롯한 원하는 도구를 사용하여 처리할 수 있는 이진 순환 로그를 생성합니다.

Circular Tracing 샘플에서 순환 로깅을 수행하는 대체 수신기에 대한 자세한 내용을 찾아볼 수도 있습니다.

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

Windows Communication Foundation 샘플의 일회성 설치 절차를 수행했는지 확인합니다.
솔루션을 빌드하려면 Windows Communication Foundation 샘플 빌드의 지침을 따릅니다.

참고 항목

RegisterProvider.bat, SetupETW.bat 및 CleanupETW.bat 명령을 사용하려면 로컬 관리자 계정으로 실행해야 합니다. 또한 Windows Vista 이상을 사용하는 경우에는 명령 프롬프트를 높은 권한으로 실행해야 합니다. 이렇게 하려면 명령 프롬프트 아이콘을 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 클릭합니다.
샘플을 실행하기 전에 RegisterProvider.bat를 클라이언트와 서버에서 실행합니다. 이렇게 하면 Service Trace Viewer에서 읽을 수 있는 추적을 생성하도록 결과 ETWTracingSampleLog.etl 파일이 설정됩니다. 이 파일은 C:\logs 폴더에 있습니다. 이 폴더가 없을 경우 만들어야 하며 그렇지 않으면 추적이 생성되지 않습니다. 그런 다음 클라이언트 및 서버 컴퓨터에서 SetupETW.bat를 실행하여 ETW 추적 세션을 시작합니다. SetupETW.bat 파일은 CS\Client 폴더에 있습니다.
단일 컴퓨터 또는 다중 컴퓨터 구성에서 샘플을 실행하려면 Windows Communication Foundation 샘플 실행의 지침을 따릅니다.
샘플이 완료되면 CleanupETW.bat를 실행하여 ETWTracingSampleLog.etl 파일 만들기를 완료합니다.
Service Trace Viewer 내에서 ETWTracingSampleLog.etl 파일을 엽니다. 이진 형식 파일을 .svclog 파일로 저장하라는 메시지가 표시됩니다.
서비스 추적 뷰어 내에서 새로 만든 .svclog 파일을 열어 ETW 및 ServiceModel 추적을 봅니다.

참고 항목

AppFabric 모니터링 샘플

ETW 추적

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

참고 항목

추가 리소스