연결Attach

VSPerfCmd.exe Attach 옵션은 PID(프로세스 ID)로 지정된 실행 중인 프로세스의 샘플 프로파일링을 시작합니다.The VSPerfCmd.exe Attach option begins sample profiling of the running process specified by the process ID (PID).

Attach 옵션을 사용하려면 Start 옵션에서 Sample 메서드를 지정해야 합니다.To use the Attach option, you must specify the Sample method in the Start option.

참고

Start 옵션이 Crosssession 옵션으로 지정된 경우 VSPerfCmd/Attach 또는 VSPerfCmd/Detach에 대한 모든 호출은 Crosssession을 지정해야 합니다.If the Start option was specified with the Crosssession option, any calls to VSPerfCmd /Attach or to VSPerfCmd /Detach must also specify Crosssession.

구문Syntax

VSPerfCmd.exe /Attach:ProcessID [Options]  

매개 변수Parameters

ProcessID
실행 중인 프로세스의 PID(프로세스 ID)입니다.The process ID (PID) of the running process. 실행 중인 프로세스의 PID는 Windows 작업 관리자의 프로세스 탭에 나열됩니다.The PID of a running process is listed on the Processes tab of Windows Task Manager.

유효한 옵션Valid Options

다음 VSPerfCmd 옵션은 단일 명령줄에서 Attach 옵션과 함께 결합될 수 있습니다.The following VSPerfCmd options can be combined with the Attach option on a single command line.

CrosssessionCrosssession
로그온 세션 이외의 세션에서 프로파일링 응용 프로그램을 활성화합니다.Enables profiling applications in sessions other than the logon session. Start 옵션이 Crosssession 옵션으로 지정된 경우 필요합니다.Required if the Start option was specified with the Crosssession option.

Start: MethodStart: Method
명령줄 프로파일러 세션을 초기화하고 지정된 프로파일링 방법을 설정합니다.Initializes the command-line profiler session and sets the specified profiling method.

TargetCLRTargetCLR
프로파일링 세션에 두 개 이상의 버전이 로드된 경우 프로파일링할 .NET Framework CLR(공용 언어 런타임) 버전을 지정합니다.Specifies the version of the .NET Framework Common Language Runtime (CLR) to profile when more than one version is loaded in a profiling session. 기본적으로 첫 번째 로드된 버전이 프로파일링됩니다.By default, the first loaded version is profiled.

GlobalOn GlobalOffGlobalOn GlobalOff
프로파일링을 다시 시작(GlobalOn)하거나 일시 중지(GlobalOff)하지만 프로파일링 세션을 종료하지 않습니다.Resumes (GlobalOn) or pauses (GlobalOff) profiling, but does not end the profiling session.

ProcessOn: PID ProcessOff: PIDProcessOn: PID ProcessOff: PID
지정된 프로세스에 대한 프로파일링을 다시 시작(ProcessOn)하거나 일시 중지(ProcessOff)합니다.Resumes (ProcessOn) or pauses (ProcessOff) profiling for the specified process.

간격 옵션Interval Options

다음 샘플링 간격 옵션 중 하나를 Attach 명령줄에 지정할 수 있습니다.One of the following sampling interval options can be specified on the Attach command line. 기본 샘플링 간격은 10,000,000 프로세서 클록 주기입니다.The default sampling interval is 10,000,000 processor clock cycles.

Timer[:Cycles]PF[:Events]Sys[:Events]Counter[:Name,Reload,FriendlyName]Timer[:Cycles]PF[:Events]Sys[:Events]Counter[:Name,Reload,FriendlyName]
샘플링 간격의 종류와 수를 지정합니다.Specifies the number and type of the sampling interval.

  • Timer - 모든 Cycles 프로세서 클록 주기를 샘플링합니다.Timer - Samples every Cycles processor clock cycles. Cycles를 지정하지 않은 경우 10,000,000 주기가 사용됩니다.If Cycles is not specified, 10,000,000 cycles are used.

  • PF - 모든 Events 페이지 폴트를 샘플링합니다.PF - Samples every Events page faults. Events가 지정되지 않은 경우 10 페이지 폴트가 사용됩니다.If Events is not specified, 10 page faults are used.

  • Sys - 운영 체제에 대한 모든 Events 호출을 샘플링합니다.Sys - Samples every Events calls to the operating system. Events가 지정되지 않은 경우 10 시스템 호출이 사용됩니다.If Events is not specified, 10 system calls are used.

  • Counter - Name에서 지정된 CPU 성능 카운터의 모든 Reload 수를 샘플링합니다.Counter - Samples every Reload number of the CPU performance counter specified by Name. 필요에 따라 FriendlyName은 프로파일러 보고서의 열 헤더로 사용할 문자열을 지정할 수 있습니다.Optionally, FriendlyName can specify a string to use as the column header in profiler reports.

예제Example

이 예제에서는 12345의 프로세스 ID로 응용 프로그램의 실행 중인 인스턴스에 연결하는 방법을 보여 줍니다.This example demonstrates how to attach to a running instance of an application with the process ID of 12345.

VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp  
VSPerfCmd.exe /Attach:12345  

참고 항목See Also

VSPerfCmd VSPerfCmd
독립 실행형 응용 프로그램 프로파일링 Profiling Stand-Alone Applications
ASP.NET 웹 응용 프로그램 프로파일링 Profiling ASP.NET Web Applications
서비스 프로파일링Profiling Services