방법: 명령줄을 통해 프로파일러와 함께 독립 실행형 네이티브 응용 프로그램을 시작하여 동시성 데이터 수집How to: Launch a Stand-Alone Native Application with the Profiler to Collect Concurrency Data by Using the Command Line

이 항목은 Visual StudioVisual Studio 프로파일링 도구 명령줄 도구를 사용하여 네이티브 독립 실행형(클라이언트) 응용 프로그램을 시작하고 프로세스 및 스레드 동시성 데이터를 수집하는 방법을 설명합니다.This topic describes how to use Visual StudioVisual Studio Profiling Tools command-line tools to start a native stand-alone (client) application and collect process and thread concurrency data.

프로파일링 세션은 다음과 같은 부분으로 구성됩니다.A profiling session has the following parts:

  • 프로파일러를 사용하여 응용 프로그램 시작Starting the application with the profiler

  • 데이터 수집 제어Controlling data collection

  • 프로파일링 세션 종료Ending the profiling session

참고

프로파일링 도구의 명령줄 도구는 Visual StudioVisual Studio 설치 디렉터리의 \Team Tools\Performance Tools 하위 디렉터리에 있습니다.Command-line tools of the Profiling Tools are located in the \Team Tools\Performance Tools subdirectory of the Visual StudioVisual Studio installation directory. 64비트 컴퓨터에서는 도구의 64비트 및 32비트 버전을 둘 다 사용할 수 있습니다.On 64-bit computers, both 64-bit and 32-bit versions of the tools are available. 명령 프롬프트에서 프로파일러를 사용하려면 도구 경로를 명령 프롬프트 창의 PATH 환경 변수에 추가하거나 명령 자체에 추가해야 합니다.To use the profiler at a command prompt, you must add the tools path to the PATH environment variable of the Command Prompt window or add it to the command itself. 자세한 내용은 명령줄 도구의 경로 지정을 참조하세요.For more information, see Specifying the Path to Command Line Tools.

프로파일러를 사용하여 응용 프로그램 시작Starting the Application with the Profiler

프로파일러를 사용하여 대상 응용 프로그램을 시작하려면 VSPerfCmd.exe/start/launch 옵션을 사용하여 프로파일러를 초기화하고 응용 프로그램을 시작합니다.To start a target application with the profiler, you use the VSPerfCmd.exe/start and /launch options to initialize the Profiler and start the application. /start/launch와 해당 개별 옵션을 지정할 수 있습니다.You can specify /start and /launch and their respective options. /globaloff 옵션을 추가하여 대상 응용 프로그램 시작 시 데이터 수집을 일시 중지할 수도 있습니다.You can also add the /globaloff option to pause data collection at the start of the target application. 그런 다음 /globalon을 사용하여 데이터 수집을 시작합니다.You then use /globalon to begin to collect data.

프로파일러를 사용하여 응용 프로그램을 시작하려면To start an application with the Profiler

  1. 명령 프롬프트에서 다음 명령을 입력합니다.At a command prompt, type the following command:

    VSPerfCmd /start:concurrency /output: OutputFile [Options]VSPerfCmd /start:concurrency /output: OutputFile [Options]

    /start에는 /output:OutputFile 옵션이 필요합니다.The /output:OutputFile option is required with /start. OutputFile은 프로파일링 데이터(.vsp) 파일의 이름과 위치를 지정합니다.OutputFile specifies the name and location of the profiling data (.vsp) file.

    /start:concurrency 옵션과 다음 표의 모든 옵션을 함께 사용할 수 있습니다.You can use any of the options in the following table with the /start:concurrency option.

    옵션Option 설명Description
    /wincounter : WinCounterPath/wincounter : WinCounterPath 프로파일링 중에 수집할 Windows 성능 카운터를 지정합니다.Specifies a Windows performance counter to be collected during profiling.
    /automark : Interval/automark : Interval /wincounter와 함께 사용해야 합니다.Use with /wincounter only. Windows 성능 카운터 수집 이벤트 사이에 경과하는 시간(밀리초)을 지정합니다.Specifies the number of milliseconds between Windows performance counter collection events. 기본값은 500입니다.The default value is 500.
    /events : Config/events : Config 프로파일링 중에 수집할 ETW(Windows용 이벤트 추적) 이벤트를 지정합니다.Specifies an Event Tracing for Windows (ETW) event to be collected during profiling. ETW 이벤트는 별도의 파일(.etl)로 수집됩니다.ETW events are collected in a separate (.etl) file.
  2. 다음을 입력하여 대상 응용 프로그램을 시작합니다.Start the target application by typing:

    VSPerfCmd /launch : AppName [Options]VSPerfCmd /launch : AppName [Options]

    /launch 옵션과 다음 표의 모든 옵션을 함께 사용할 수 있습니다.You can use any of the options in the following table with the /launch option.

    옵션Option 설명Description
    /args : Arguments/args : Arguments 대상 응용 프로그램에 전달할 명령줄 인수가 포함된 문자열을 지정합니다.Specifies a string that contains the command-line arguments to be passed to the target application.
    /console/console 대상 명령줄 응용 프로그램을 별도의 창에서 시작합니다.Starts the target command-line application in a separate window.
    /targetclr : CLRVersion/targetclr : CLRVersion 한 응용 프로그램이 두 개 이상의 CLR(공용 언어 런타임) 버전을 로드할 경우 프로파일링할 CLR 버전을 지정합니다.Specifies the version of the common language runtime (CLR) to profile if the application loads more than one version of the CLR.

데이터 수집 제어Controlling Data Collection

대상 응용 프로그램이 실행 중이면 VSPerfCmd.exe 옵션을 사용하여 파일에 대한 데이터 쓰기를 시작하고 중지하는 방식으로 데이터 수집을 제어할 수 있습니다.While the target application is running, you can control data collection by starting and stopping the writing of data to the file with VSPerfCmd.exe options. 데이터 수집을 제어하여 응용 프로그램의 시작 또는 종료와 같이 프로그램 실행의 특정 부분에 대한 데이터를 수집할 수 있습니다.By controlling data collection, you can collect data for a specific part of program execution, such as the starting or shutting down of the application.

데이터 수집을 시작 및 중지하려면To start and stop data collection

  • 다음 표의 옵션 쌍을 사용하여 데이터 수집을 시작 및 중지합니다.The pairs of options in the following table start and stop data collection. 각 옵션을 개별 명령줄에서 지정합니다.Specify each option on a separate command line. 데이터 수집을 여러 번 켜고 끌 수 있습니다.You can turn data collection on and off multiple times.

    옵션Option 설명Description
    /globalon /globaloff/globalon /globaloff 모든 프로세스에 대한 데이터 수집을 시작(/globalon) 또는 중지(/globaloff)합니다.Starts (/globalon) or stops (/globaloff) data collection for all processes.
    /processon : PID /processoff : PID/processon : PID /processoff : PID 프로세스 ID(PID)로 지정된 프로세스에 대한 데이터 수집을 시작(/processon) 또는 중지(/processoff)합니다.Starts (/processon) or stops (/processoff) data collection for the process that the process ID (PID) specifies.
    /attach :{PID|ProcName} /detach[:{PID|ProcName}]/attach :{PID|ProcName} /detach[:{PID|ProcName}] /attach는 프로세스 ID(PID) 또는 프로세스 이름(ProcName)으로 지정된 프로세스에 대한 데이터 수집을 시작합니다./attach starts to collect data for the process that the process ID (PID) or process name (ProcName) specifies. /detach는 지정된 프로세스 또는 모든 프로세스(프로세스가 지정되지 않은 경우)에 대한 데이터 수집을 중지합니다./detach stops data collection for the specified process or for all processes if no process is specified.
  • VSPerfCmd.exe/mark 옵션을 사용하여 프로파일링 표시를 데이터 파일에 삽입할 수 있습니다.You can also use the VSPerfCmd.exe/mark option to insert a profiling mark into the data file. /mark 명령은 식별자, 타임스탬프 및 선택적 사용자 정의 텍스트 문자열을 추가합니다.The /mark command adds an identifier, a time stamp, and an optional user-defined text string. 표식을 사용하여 프로파일러 보고서 및 데이터 뷰에서 데이터를 필터링할 수 있습니다.Marks can be used to filter the data in profiler reports and data views.

프로파일링 세션 종료Ending the Profiling Session

프로파일링 세션을 종료하려면 프로파일러가 데이터를 수집하고 있지 않아야 합니다.To end a profiling session, the profiler must not be collecting data. 프로파일링된 응용 프로그램을 닫거나 VSPerfCmd /detach 옵션을 호출하여 동시성 데이터 수집을 중지할 수 있습니다.You can stop collecting concurrency data by closing the profiled application or by invoking the VSPerfCmd /detach option. 그러고 나서 VSPerfCmd /shutdown 옵션을 호출하여 프로파일러를 끄고 프로파일링 데이터 파일을 닫습니다.You then invoke the VSPerfCmd /shutdown option to turn off the profiler and close the profiling data file.

프로파일링 세션을 종료하려면To end a profiling session

  1. 프로파일러를 닫거나 명령 프롬프트에서 다음 명령을 입력하여 대상 응용 프로그램에서 프로파일러를 분리합니다.Detach the profiler from the target application by closing it or by typing the following command at a command prompt:

    VSPerfCmd /detachVSPerfCmd /detach

  2. 명령 프롬프트에서 다음 명령을 입력하여 프로파일러를 종료합니다.Shut down the profiler by typing the following command at a command prompt:

    VSPerfCmd /shutdownVSPerfCmd /shutdown