VSPerfCLREnvVSPerfCLREnv

VSPerfCLREnv 도구는 .NET Framework 응용 프로그램을 프로파일링하는 데 필요한 환경 변수를 설정하는 데 사용됩니다.The VSPerfCLREnv tool is used to set environment variables that are required to profile a .NET Framework application. 이 도구는 다음 구문을 사용합니다.It uses the following syntax:

VsPerfCLREnv [/option]  

선택하는 옵션은 세 가지 프로파일링 유형(샘플링, 계측, 전역) 중 사용하는 유형에 따라 달라집니다.The option that you choose depends on which of the three types of profiling you use: sampling, instrumentation, or global. 프로파일링 데이터에 계층 상호 작용 데이터를 포함하려면 별도의 옵션이 필요합니다.A separate option is required to include tier interaction data in the profiling data. 다음 표에는 각 옵션의 구문에 대한 설명이 나와 있습니다.The syntax for each option is described in the following tables.

참고

프로파일링을 완료한 후에는 /off 또는 /globaloff 옵션을 포함해 VSPerfCLREnv를 실행하여 프로파일링에 필요한 환경 변수를 삭제합니다.When you are finished profiling, run VSPerfCLREnv with the /off or /globaloff option to delete the environment variables necessary for profiling. 자세한 내용은 이 문서에 나와 있는 환경 설정 삭제를 위한 VSPerfCLREnv 옵션을 참조하세요.For more information, see VSPerfCLREnv Options to Delete Environment Settings shown here.

계층 상호 작용 데이터를 포함하기 위한 VSPerfCLREnv 옵션VSPerfCLREnv Options for Including Tier-Interaction Data

경고

Visual Studio UltimateVisual Studio Ultimate, Visual Studio PremiumVisual Studio Premium또는 Visual Studio ProfessionalVisual Studio Professional을 사용하여 계층 상호 작용 프로파일링 데이터를 수집할 수 있습니다.Tier interaction profiling can be collected using Visual Studio UltimateVisual Studio Ultimate, Visual Studio PremiumVisual Studio Premium, or Visual Studio ProfessionalVisual Studio Professional. 그러나 계층 상호 작용 프로파일링 데이터는 Visual Studio UltimateVisual Studio UltimateVisual Studio PremiumVisual Studio Premium에서만 볼 수 있습니다.However, tier interaction profiling data can be viewed only in Visual Studio UltimateVisual Studio Ultimate and Visual Studio PremiumVisual Studio Premium.

계층 상호 작용 프로파일링에서는 다층 계층 응용 프로그램의 ADO.NET 쿼리에 대한 추가 정보를 제공합니다.Tier interaction profiling provides additional information about ADO.NET queries in multi-tiered applications. 동기 함수 호출에 대해서만 데이터가 수집됩니다.Data is collected only for synchronous function calls. 원하는 프로파일링 방법을 사용하여 상호 작용 데이터를 프로파일링 실행에 추가할 수 있습니다.Interaction data can be added to any profiling run using any profiling method.

InteractionOnGlobalInteractionOn 옵션을 사용하면 계층 상호 작용 데이터를 수집할 수 있습니다.The InteractionOn and GlobalInteractionOn options enable the collection of tier interaction data. 응용 프로그램을 프로파일링하는 데 필요한 VSPerfCLREnv 환경 변수를 설정한 후에 상호 작용 옵션을 설정해야 합니다.The interaction option must be set after setting the VSPerfCLREnv environment variable that is required to profile a application.

다음 예제에는 샘플링 방법을 사용하는 프로파일링 실행의 계층 상호 작용 데이터가 포함되어 있습니다.The following example includes tier interaction data in a profiling run that uses the sampling method:

VSPerfCLREnv /SampleOn  
VSPerfCLREnv /InteractionOn  
VSPerfCmd /Start:Sample /Output:MyApp.exe.vsp /Launch:MyApp.exe  

다음 예제에는 Windows 서비스에 대한 프로파일링 실행의 계층 상호 작용 데이터가 포함되어 있습니다.The following example includes tier interaction data in a profiling run for a Windows service:

VSPerfCLREnv /GlobalSampleOn  
VSPerfCLREnv /GlobalInteractionOn  
REM Restart the computer and start the service  
VSPerfCmd /Start:Sample /Output:MyService.exe.vsp   
VSPerfCmd /Attach:MyService.exe  

프로세스 계측 프로파일링을 위한 VSPerfCLREnv 옵션VSPerfCLREnv Options for Process Instrumentation Profiling

다음 표에는 계측 프로파일링을 위한 VSPerfCLREnv 옵션에 대한 설명이 나와 있습니다.The following table describes VSPerfCLREnv options for instrumentation profiling:

옵션Option 설명Description
TraceOnTraceOn 계측 방법을 사용하여 프로파일링을 활성화합니다.Enables profiling using the instrumentation method. 메모리 할당 프로파일링 또는 개체 수명 데이터 수집은 활성화되지 않습니다.Does not enable memory allocation profiling or collecting object lifetime data.
TraceGCTraceGC 계측 방법을 사용하여 메모리 할당 프로파일링을 활성화합니다.Enables memory allocation profiling using the instrumentation method. 개체 수명 데이터 수집은 활성화되지 않습니다.Does not enable collecting object lifetime data.
TraceGCLifeTraceGCLife 계측 방법을 사용하여 메모리 할당 프로파일링 및 개체 수명 데이터 수집을 활성화합니다.Enables memory allocation profiling and collecting object lifetime data using the instrumentation method.

프로세스 샘플링 프로파일링을 위한 VSPerfCLREnv 옵션VSPerfCLREnv Options for Process Sampling Profiling

다음 표에는 샘플링 프로파일링을 위한 VSPerfCLREnv 옵션에 대한 설명이 나와 있습니다.The following table describes VSPerfCLREnv options for sampling profiling:

옵션Option 설명Description
SampleOnSampleOn 샘플링 방법을 사용하여 프로파일링을 활성화합니다.Enables profiling using the sampling method. 메모리 할당 프로파일링 또는 개체 수명 데이터 수집은 활성화되지 않습니다.Does not enable memory allocation profiling or collecting object lifetime data.
SampleGCSampleGC 샘플링 방법을 사용하여 메모리 할당 프로파일링을 활성화합니다.Enables memory allocation profiling using the sampling method. 개체 수명 데이터 수집은 활성화되지 않습니다.Does not enable collecting object lifetime data.
SampleGCLifeSampleGCLife 샘플링 방법을 사용하여 메모리 할당 프로파일링을 활성화합니다.Enables memory allocation profiling using the sampling method. 개체 수명 데이터 수집도 활성화됩니다.Also enables collecting object lifetime data.
SampleLineOffSampleLineOff .NET 줄 수준 프로파일링 데이터 수집을 비활성화합니다.Disables the collection of .NET line-level profiling data.

전역 프로파일링을 위한 VSPerfCLREnv 옵션VSPerfCLREnv Options for Global Profiling

사용자가 시작하는 것이 아니라 운영 체제에 의해 시작되는 ASP.NET 웹 응용 프로그램과 관리 서비스를 프로파일링하려면 VSPerfCLREnv 옵션의 전역 프로파일링용 옵션을 사용합니다.To profile a managed service such as and ASP.NET web application that is started by the operating system instead of being started by the user, use options for global profiling of the VSPerfCLREnv options. 다음 표에는 VSPerfCLREnv 옵션의 전역 버전에 대한 설명이 나와 있습니다.The following table describes the global versions of VSPerfCLREnv options. 이러한 옵션은 레지스트리에서 적절한 환경 변수를 설정합니다.These options set the appropriate environment variables in the registry.

옵션Option 설명Description
GlobalTraceOnGlobalTraceOn 계측 방법을 사용하여 전역 프로파일링을 활성화합니다.Enables global profiling using the instrumentation method. 메모리 할당 이벤트 또는 개체 수명 데이터는 수집되지 않습니다.Does not collect memory allocation events or object lifetime data.
GlobalTraceGCGlobalTraceGC 계측 방법을 사용하여 전역 메모리 할당 프로파일링을 활성화합니다.Enables global memory allocation profiling using the instrumentation method. 개체 수명 데이터 수집은 활성화되지 않습니다.Does not enable collecting object lifetime data.
GlobalTraceGCLifeGlobalTraceGCLife 계측 방법을 사용하여 전역 메모리 할당 프로파일링을 활성화합니다.Enables global memory allocation profiling using the instrumentation method. 개체 수명 데이터 수집도 활성화됩니다.Also enables the collection of object lifetime data.
GlobalSampleOnGlobalSampleOn 샘플링 방법을 사용하여 전역 프로파일링을 활성화합니다.Enables global profiling using the sampling method. 메모리 할당 이벤트 또는 개체 수명 데이터 수집은 활성화되지 않습니다.Does not enable collecting memory allocation events or object lifetime data.
GlobalSampleGCGlobalSampleGC 샘플링 방법을 사용하여 전역 메모리 할당 프로파일링을 활성화합니다.Enables global memory allocation profiling using the sampling method. 개체 수명 데이터 수집은 활성화되지 않습니다.Does not enable collecting object lifetime data.
GlobalSampleGCLifeGlobalSampleGCLife 샘플링 방법을 사용하여 전역 메모리 할당 프로파일링을 활성화합니다.Enables global memory allocation profiling using the sampling method. 개체 수명 데이터 수집도 활성화됩니다.Also enables collecting object lifetime data.

환경 설정 삭제를 위한 VSPerfCLREnv 옵션VSPerfCLREnv Options to Delete Environment Settings

관리되는 응용 프로그램 프로파일링을 완료한 후에는 다음 옵션 중 하나를 사용하여 VSPerfCLREnv가 추가한 환경 변수를 삭제합니다.When you are finished profiling the managed application, use one of the following options to delete the environment variables that were added by VSPerfCLREnv. 다음 표에서는 표준 환경 변수와 전역 환경 변수를 둘 다 삭제하는 방법을 설명합니다.The following table describes how to delete both standard and global environment variables:

옵션Option 설명Description
OffOff 표준 .NET 프로파일링용 환경 변수를 삭제합니다.Deletes environment variables for standard .NET profiling. 비전역 VSPerfClrEnv 옵션을 사용하여 프로파일러 환경 변수를 설정한 경우 이 옵션을 사용합니다.Use this option when the non-global VSPerfClrEnv options were used to set the profiler environment variables.
GlobalOffGlobalOff 전역 .NET 프로파일링용 환경 변수를 삭제합니다.Deletes environment variables for global .NET profiling. 프로파일러가 아닌 운영 체제에 의해 응용 프로그램이 시작된 경우 이 옵션을 사용합니다.Use this option when the application was started by the operating system and not the profiler.

설명Remarks

IDE의 성능 탐색기를 사용하여 응용 프로그램을 시작한 경우에는 관리되는 응용 프로그램을 프로파일링하는 데 이러한 옵션이 필요하지 않습니다.These options are not required for profiling a managed application if the application is started by using the Performance Explorer in the IDE. 성능 탐색기가 필요한 모든 환경 설정을 자동으로 지정합니다.The Performance Explorer sets all the required environment settings for you.

프로파일링 중에 올바른 환경이 설정되지 않은 경우에는 분석 중에 경고가 보고되며 관리되는 함수 이름이 적절하게 확인되지 않습니다.If the correct environment was not set during profiling, a warning is reported during analysis and the managed function names will not be properly resolved.

참고 항목See Also

명령줄에서 프로파일링Profiling from the Command-Line