이벤트 뷰어

사용자 지정 ETW 이벤트 사용

사용자 지정 ETW 이벤트를 사용하여 코드를 계측하고 이벤트 뷰어에 표시되도록 설정할 수 있습니다. 사용자 지정 이벤트를 사용하도록 설정하려면 다음을 수행합니다.

1. 사용자 지정 이벤트 코드를 빌드합니다.

   C++ 사용자 지정 이벤트 코드의 예는 이 섹션의 끝에 제공됩니다.

2. 성능 프로파일러(Alt + F2)를 열고 이벤트 뷰어를 사용하도록 설정한 다음 옆에 있는 설정 아이콘(기어 아이콘)을 선택합니다.

   

3. 대화 상자에서 추가 공급자 아래 의 첫 번째 행을 사용하도록 설정한 다음 작업 중 하나를 수행합니다.

   • 네이티브 사용자 지정 이벤트 코드의 경우 사용자 지정 이벤트 코드의 GUID에 따라 공급자 GUID를 설정하고 공급자 이름 값을 비워 두거나 기본값을 사용합니다.

   • C# 사용자 지정 이벤트 코드의 경우 이벤트 코드를 선언할 때 사용한 것과 동일한 공급자 이름 값을 설정합니다. 이 이름은 백그라운드에서 GUID로 변환되므로 공급자 GUID를 비워 둡니다.

     네이티브 사용자 지정 이벤트의 경우 행은 다음 그림과 유사하게 표시됩니다.

     

4. 확인을 선택합니다.

   사용자 지정 이벤트는 진단 추적을 수집하고 열 때 이벤트 뷰어에 표시됩니다. 다음 그림에서는 사용자 지정 이벤트만 표시하도록 필터링이 설정된 이벤트 뷰어의 사용자 지정 이벤트를 보여 줍니다.

   

다음은 C++에 대한 사용자 지정 이벤트 코드의 예입니다.

#include <Windows.h>
#include <evntprov.h>
#include <iostream>
#include <thread>

// This GUID must be regenerated so it is unique for your provider
// {7369B7AC-64EB-4618-B6B6-C8442B12E8F2}
GUID customEventProvider = { 0x7369b7ac, 0x64eb, 0x4618, { 0xb6, 0xb6, 0xc8, 0x44, 0x2b, 0x12, 0xe8, 0xf2 } };
REGHANDLE _customEventProviderRegHandle = 0;

// Id, Version, Channel, Level, OpCode, Task, Keyword
const EVENT_DESCRIPTOR CustomEventDescriptor = { 1, 0, 0, 0, 0, 0, 1 };

int main()
{
    // Register the provider
    ULONG res = ::EventRegister(&customEventProvider, nullptr, nullptr, &_customEventProviderRegHandle);
    if (res != ERROR_SUCCESS)
    {
        return res;
    }

    byte data[] = { 0xFF, 0xFF, 0xFF, 0xFF };
    EVENT_DATA_DESCRIPTOR eventData[1];
    ::EventDataDescCreate(&(eventData[0]), &data, sizeof(data));

    for (int i = 0; i < 10; ++i)
    {
        std::this_thread::sleep_for(std::chrono::milliseconds(1000));
        ::EventWrite(_customEventProviderRegHandle, &CustomEventDescriptor, _countof(eventData), eventData);
        std::cout << "Wrote event\n";
    }

    res = ::EventUnregister(_customEventProviderRegHandle);
    if (res != ERROR_SUCCESS)
    {
        return res;
    }

    return 0;
}