IntelliTrace 독립 실행형 수집기를 사용하여 프로덕션에서 진단 데이터 수집

아티클
11/25/2015

IntelliTrace 독립 실행형 수집기를 사용하면 대상 컴퓨터에 Visual Studio를 설치하거나 대상 시스템 환경을 변경하지 않고도 프로덕션 서버 또는 기타 환경에서 앱에 대해 IntelliTrace 진단 데이터를 수집할 수 있습니다. IntelliTrace 독립 실행형 수집기는 웹, SharePoint, WPF 및 Windows Forms 앱에서 작동합니다. 데이터 수집을 마쳤으면 컬렉터를 삭제하여 제거하면 됩니다.

IntelliTrace의 실제 작동 방식은 디버깅을 위해 프로덕션에서 IntelliTrace 데이터 수집 및 분석(채널 9 비디오)을 참조하세요.

참고

추적 모드에서 Microsoft Monitoring Agent를 사용하면 원격 컴퓨터에서 실행되는 SharePoint 앱 및 웹에 대해 같은 IntelliTrace 데이터를 수집할 수도 있습니다.

모니터 모드에서 에이전트를 실행하면 IntelliTrace 데이터에서 성능 관련 이벤트를 수집할 수 있습니다.모니터 모드는 추적 모드 또는 IntelliTrace 독립 실행형 수집기에 비해 성능에 주는 영향이 적습니다.Microsoft Monitoring Agent는 설치 시 대상 시스템 환경을 변경합니다.Microsoft Monitoring Agent를 사용하여 프로덕션에서 IntelliTrace 진단 및 성능 데이터 수집을 참조하십시오.

요구 사항

.NET Framework
.iTrace 파일을 열기 위한 개발 컴퓨터 또는 다른 컴퓨터의 Visual Studio Ultimate 2015

참고

기호(.pdb) 파일을 저장해야 합니다.IntelliTrace를 사용하여 코드를 디버그하고 단계별로 실행하려면 일치하는 소스 파일과 기호 파일이 있어야 합니다.배포 후 문제를 진단하기 위해 릴리스를 설정을 참조하십시오.

FAQ

컬렉터를 사용할 수 있는 앱
시작하는 방법
앱 속도를 그대로 유지하면서 데이터를 최대한 수집하는 방법
IntelliTrace 데이터를 가져올 수 있는 다른 위치

컬렉터를 사용할 수 있는 앱

IIS(인터넷 정보 서비스)에서 호스트되는 ASP.NET 웹앱
SharePoint 2010 및 SharePoint 2013 응용 프로그램
WPF(Windows Presentation Foundation) 및 Windows Forms 앱

시작하는 방법

Install the collector.
Set up permissions for the collector directory.
For Web apps and SharePoint applications, install the IntelliTrace PowerShell cmdlets.
Set up permissions for the .iTrace file directory.
Collect data from a Web app or SharePoint application.

또는

Collect data from a managed app.
Open the .iTrace file in Visual Studio Ultimate.

수집기 설치

앱 서버에서 C:\IntelliTraceCollector와 같은 수집기 디렉터리를 만듭니다.
Microsoft 다운로드 센터 또는 Visual Studio 2103 업데이트 3 설치 폴더에서 수집기를 다운로드하거나 가져옵니다. Visual Studio 2013 업데이트 4용 IntelliTrace 수집기:
- Microsoft 다운로드 센터:
  1. IntelliTraceCollector.exe 옆의 다운로드를 선택합니다.
  2. IntelliTraceCollector.exe를 C:\IntelliTraceCollector와 같은 수집기 디렉터리에 저장합니다.
  3. IntelliTraceCollector.exe를 실행합니다. 그러면 IntelliTraceCollection.cab 파일이 추출됩니다.
  또는
- Visual Studio 설치 폴더:
  1. IntelliTraceCollection.cab를 다음 폴더에 복사합니다.
    
    .. \Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\IntelliTrace\12.0.0
  2. IntelliTraceCollection.cab를 C:\IntelliTraceCollector와 같은 수집기 디렉터리에 저장합니다.
다음 단계를 수행하여 IntelliTraceCollection.cab를 확장합니다.
1. 앱 서버에서 관리자 권한으로 명령 프롬프트 창을 엽니다.
2. C:\IntelliTraceCollector와 같은 수집기 디렉터리로 이동합니다.
3. 끝의 마침표(expand.)를 포함한 다음 명령을 사용하여 IntelliTraceCollection.cab를 확장합니다.
  
  expand /f:* IntelliTraceCollection.cab .
  
  참고
  
  마침표(.)는 지역화된 수집 계획을 포함하는 하위 폴더를 보존합니다.

수집기 디렉터리에 대한 사용 권한 설정

앱 서버에서 관리자 권한으로 명령 프롬프트 창을 엽니다.
Windows icacls 명령을 사용하여 서버 관리자에게 수집기 디렉터리에 대한 모든 권한을 제공합니다. 예를 들면 다음과 같습니다.

icacls "C:\IntelliTraceCollector" /grant " <Domain\AdministratorID> ":F
웹 앱 또는 SharePoint 응용 프로그램에서 데이터를 수집하려면 다음 단계를 수행합니다.
1. IntelliTrace PowerShell cmdlet을 실행하는 사용자에게 수집기 디렉터리에 대한 모든 권한을 제공합니다.
  
  예를 들면 다음과 같습니다.
  
  icacls "C:\IntelliTraceCollector" /grant " <Domain\UserID> ":F
2. 웹 앱 또는 SharePoint 응용 프로그램의 응용 프로그램 풀에 수집기 디렉터리에 대한 읽기 및 실행 권한을 제공합니다.
  
  예를 들면 다음과 같습니다.
  - DefaultAppPool 응용 프로그램 풀의 웹 앱:
    
    icacls "C:\IntelliTraceCollector" /grant "IIS APPPOOL\DefaultAppPool":RX
  - SharePoint - 80 응용 프로그램 풀의 SharePoint 응용 프로그램:
    
    icacls "C:\IntelliTraceCollector" /grant "IIS APPPOOL\SharePoint - 80":RX

IntelliTrace PowerShell cmdlet을 설치하고 웹 응용 프로그램 또는 SharePoint 응용 프로그램에 대한 데이터를 수집

앱 서버에서 PowerShell이 사용하도록 설정되어 있는지 확인합니다. 대부분 Windows Server 버전에서는 서버 관리자 관리 도구에서 이 기능을 추가할 수 있습니다.
IntelliTrace PowerShell cmdlet을 설치합니다.
1. 관리자 권한으로 PowerShell 명령 창을 엽니다.
  1. 시작, 모든 프로그램, 보조프로그램, Windows PowerShell을 차례로 선택합니다.
  2. 다음 단계 중 하나를 선택합니다.
    - 64비트 운영 체제에서는 Windows PowerShell의 바로 가기 메뉴를 엽니다. 관리자 권한으로 실행을 선택합니다.
    - 32비트 운영 체제에서는 **Windows PowerShell(x86)**의 바로 가기 메뉴를 엽니다. 관리자 권한으로 실행을 선택합니다.
2. PowerShell 명령 창에서 Import-Module 명령을 사용하여 Microsoft.VisualStudio.IntelliTrace.PowerShell.dll을 가져옵니다.
  
  예를 들면 다음과 같습니다.
  
  Import-Module "C:\IntelliTraceCollector\Microsoft.VisualStudio.IntelliTrace.PowerShell.dll"

.iTrace 파일 디렉터리에 대한 사용 권한 설정

앱 서버에서 C:\IntelliTraceLogFiles와 같은 .iTrace 파일 디렉터리를 만듭니다.

참고

앱 속도 저하를 방지하려면 사용량이 많지 않은 로컬 고속 디스크의 위치를 선택합니다.
.ITrace 파일과 수집기 파일은 같은 위치에 배치할 수 있습니다.그러나 웹 앱 또는 SharePoint 응용 프로그램이 있는 경우에는 이 위치가 응용 프로그램을 호스트하는 디렉터리 외부에 있어야 합니다.

보안 정보
.ITrace 파일 디렉터리는 수집기에서 사용해야 하는 ID만으로 제한합니다.IntelliTrace는 메서드 매개 변수로 또는 반환 값으로 전달되는 데이터를 기록할 수 있으므로 .iTrace 파일은 사용자, 데이터베이스, 기타 소스 정보 및 연결 문자열의 데이터와 같은 중요한 정보를 포함할 수 있습니다. .ITrace 파일을 열 수 있는 사용자에게 중요한 데이터를 볼 수 있는 권한이 있는지 확인합니다..ITrace 파일을 공유할 때는 주의해야 합니다.다른 사람이 액세스해야 하는 파일은 안전한 공유 위치에 복사합니다.

.ITrace 파일 디렉터리는 수집기에서 사용해야 하는 ID만으로 제한합니다.IntelliTrace는 메서드 매개 변수로 또는 반환 값으로 전달되는 데이터를 기록할 수 있으므로 .iTrace 파일은 사용자, 데이터베이스, 기타 소스 정보 및 연결 문자열의 데이터와 같은 중요한 정보를 포함할 수 있습니다.
.ITrace 파일을 열 수 있는 사용자에게 중요한 데이터를 볼 수 있는 권한이 있는지 확인합니다..ITrace 파일을 공유할 때는 주의해야 합니다.다른 사람이 액세스해야 하는 파일은 안전한 공유 위치에 복사합니다.

웹 앱 또는 SharePoint 응용 프로그램의 경우에는 .iTrace 파일 디렉터리에 대한 모든 권한을 해당 응용 프로그램 풀에 제공합니다. Windows icacls 명령이나 Windows 탐색기 또는 파일 탐색기를 사용할 수 있습니다.

예를 들면 다음과 같습니다.
- Windows icacls 명령을 통해 사용 권한을 설정하려면 다음 명령을 사용합니다.
  - DefaultAppPool 응용 프로그램 풀의 웹 앱:
    
    icacls "C:\IntelliTraceLogFiles" /grant "IIS APPPOOL\DefaultAppPool":F
  - SharePoint - 80 응용 프로그램 풀의 SharePoint 응용 프로그램:
    
    icacls "C:\IntelliTraceLogFiles" /grant "IIS APPPOOL\SharePoint - 80":F
  또는
- Windows 탐색기 또는 파일 탐색기를 통해 사용 권한을 설정하려면 다음 단계를 수행합니다.
  1. .iTrace 파일 디렉터리의 속성을 엽니다.
  2. 보안 탭에서 편집, 추가를 차례로 선택합니다.
  3. 개체 유형을 선택하세요. 상자에 기본 제공 보안 계정이 표시되는지 확인하고 표시되지 않으면 개체 형식을 선택하여 추가합니다.
  4. 찾을 위치를 선택하세요. 상자에 로컬 컴퓨터가 표시되는지 확인하고 표시되지 않으면 위치를 선택하여 변경합니다.
  5. 선택할 개체 이름을 입력하세요. 상자에 웹 앱 또는 SharePoint 응용 프로그램의 응용 프로그램 풀을 추가합니다.
  6. 이름 확인을 선택하여 이름을 확인합니다. 확인을 선택합니다.
  7. 응용 프로그램 풀에 모든 권한이 있는지 확인합니다.

웹 응용 프로그램 또는 SharePoint 응용 프로그램에서 데이터 수집

데이터 수집을 시작하려면 관리자 권한으로 PowerShell 명령 창을 열고 다음 명령을 실행 합니다.

Start-IntelliTraceCollection "<ApplicationPool>" <PathToCollectionPlan> <FullPathToITraceFileDirectory>

중요

이 명령을 실행한 후 Y를 입력하여 데이터 수집 시작을 확인합니다.

예를 들어 SharePoint - 80 응용 프로그램 풀의 SharePoint 응용 프로그램에서 데이터를 수집하려면 다음 명령을 실행합니다.

Start-IntelliTraceCollection "SharePoint - 80" "C:\IntelliTraceCollector\collection_plan.ASP.NET.default.xml" "C:\IntelliTraceLogFiles"

ApplicationPool

응용 프로그램이 실행되는 응용 프로그램 풀의 이름입니다.

PathToCollectionPlan

수집 계획(수집기의 설정을 구성하는 .xml 파일)의 경로입니다.

수집기와 함께 제공되는 계획을 지정할 수 있습니다. 다음 계획은 웹 앱 및 SharePoint 응용 프로그램에 대해 사용할 수 있습니다.

collection_plan.ASP.NET.default.xml

예외, 데이터베이스 호출 및 웹 서버 요청을 포함한 IntelliTrace 이벤트 및 SharePoint 이벤트만 수집합니다.
collection_plan.ASP.NET.trace.xml

함수 호출과 collection_plan.ASP.NET.default.xml의 모든 데이터를 수집합니다. 이 계획은 상세 분석의 경우에는 효율적이지만 collection_plan.ASP.NET.default.xml에 비해 앱의 속도는 더 느려질 수 있습니다.

앱 속도 저하를 방지하려면 이러한 계획을 사용자 지정하거나 계획을 직접 만듭니다. 보안을 유지하려면 수집기 파일과 같은 안전한 위치에 사용자 지정 계획을 저장합니다. IntelliTrace 수집 계획 작성 및 사용자 지정과 How can I get the most data without slowing down my app?을 참조하세요.

참고

기본적으로 .iTrace 파일의 최대 크기는 100MB입니다..ITrace 파일이 이 제한에 도달하면 수집기는 파일의 가장 오래된 항목을 삭제하여 새 항목을 저장하기 위한 공간을 확보합니다.이 제한을 변경하려면 수집 계획의 MaximumLogFileSize 특성을 편집합니다.

수집 계획의 지역화된 버전을 찾을 수 있는 위치

수집기 하위 폴더에서 지역화된 계획을 찾을 수 있습니다.

FullPathToITraceFileDirectory

.ITrace 파일 디렉터리의 전체 경로입니다.

보안 정보
상대 경로가 아닌 전체 경로를 지정합니다.

수집기는 응용 프로그램 풀에 연결되어 데이터 수집을 시작합니다. 지금은 .iTrace 파일을 열 수 없습니다. 데이터 수집 중에는 파일이 잠겨 있습니다.

문제를 재현합니다.
.iTrace 파일의 스냅숏을 만들려면 다음 구문을 사용합니다.

Checkpoint-IntelliTraceCollection "<ApplicationPool>"
수집 상태를 확인하려면 다음 구문을 사용합니다.

Get-IntelliTraceCollectionStatus
데이터 수집을 중지하려면 다음 구문을 사용합니다.

Stop-IntelliTraceCollection "<ApplicationPool>"

중요

이 명령을 실행한 후 Y를 입력하여 데이터 수집 중지를 확인합니다.그렇지 않으면 수집기가 데이터를 계속 수집하거나 iTrace 파일이 잠긴 상태로 유지되거나 파일에 유용한 데이터가 포함되지 않을 수 있습니다.
Open the .iTrace file in Visual Studio Ultimate.

관리되는 앱에서 데이터를 수집합니다.

앱을 시작하는 동시에 데이터를 수집하려면 다음 구문을 사용합니다.

<FullPathToIntelliTraceCollectorExecutable> \IntelliTraceSC.exe launch /cp: <PathToCollectionPlan> /f:<FullPathToITraceFileDirectoryAndFileName> <PathToAppExecutableFileAndFileName>

예를 들어 MyApp 앱에서 데이터를 수집하려면 다음 명령을 실행합니다.

C:\IntelliTraceCollector\IntelliTraceSC.exe launch /cp:"C:\IntelliTraceCollector\collection_plan.ASP.NET.default.xml" /f:"C:\IntelliTraceLogFiles\MyApp.itrace" "C:\MyApp\MyApp.exe"

FullPathToIntelliTraceCollectorExecutable

수집기 실행 파일인 IntelliTraceSC.exe의 전체 경로입니다.

PathToCollectionPlan

수집 계획(수집기의 설정을 구성하는 .xml 파일)의 경로입니다.

수집기와 함께 제공되는 계획을 지정할 수 있습니다. 관리되는 앱에 사용할 수 있는 계획은 다음과 같습니다.

collection_plan.ASP.NET.default.xml

예외, 데이터베이스 호출 및 웹 서버 요청을 포함한 IntelliTrace 이벤트만 수집합니다.
collection_plan.ASP.NET.trace.xml

함수 호출과 collection_plan.ASP.NET.default.xml의 모든 데이터를 수집합니다. 이 계획은 상세 분석의 경우에는 효율적이지만 collection_plan.ASP.NET.default.xml에 비해 앱의 속도는 더 느려질 수 있습니다.

참고

수집 계획의 지역화된 버전을 찾을 수 있는 위치

수집기 하위 폴더에서 지역화된 계획을 찾을 수 있습니다.

FullPathToITraceFileDirectoryAndFileName

.ITrace 파일 디렉터리의 전체 경로와 확장명이 .itrace인 .iTrace 파일 이름입니다.

보안 정보
상대 경로가 아닌 전체 경로를 지정합니다.

PathToAppExecutableFileAndFileName

관리되는 앱의 경로 및 파일 이름입니다.

앱을 종료하여 데이터 수집을 중지합니다.
Open the .iTrace file in Visual Studio Ultimate.

Visual Studio Ultimate에서 iTrace 파일 열기

참고

IntelliTrace를 사용하여 코드를 디버그하고 단계별로 실행하려면 일치하는 소스 파일과 기호 파일이 있어야 합니다.배포 후 문제를 진단하기 위해 릴리스를 설정을 참조하세요.

.ITrace 파일을 Visual Studio Ultimate가 설치된 컴퓨터로 이동하거나 복사합니다.
Visual Studio 외부에서 .iTrace 파일을 두 번 클릭하거나 Visual Studio 내부에서 파일을 엽니다.

Visual Studio에 IntelliTrace 요약 페이지가 표시됩니다. 대부분의 섹션에서 이벤트나 기타 항목을 검토하고, 항목을 선택하고, 이벤트가 발생한 시간 및 위치에 해당하는 지점에서 IntelliTrace를 사용하여 디버깅을 시작할 수 있습니다. 저장된 IntelliTrace 데이터를 사용하여 응용 프로그램 디버깅을 참조하세요.

참고

IntelliTrace를 사용하여 코드를 디버그하고 단계별로 실행하려면 개발 컴퓨터에 일치하는 소스 파일과 기호 파일이 있어야 합니다.배포 후 문제를 진단하기 위해 릴리스를 설정을 참조하세요.

앱 속도를 그대로 유지하면서 데이터를 최대한 수집하는 방법

IntelliTrace는 많은 데이터를 수집할 수 있으므로 앱 성능에 대한 영향은 수집하는 데이터와 분석하는 코드의 종류에 따라 달라집니다. 프로덕션 서버에서 IntelliTrace 컬렉션 최적화(영문)를 참조하세요.

앱 속도를 그대로 유지하면서 대부분의 데이터를 가져올 수 있는 몇 가지 방법은 다음과 같습니다.

문제가 있다고 생각되거나 문제를 재현할 수 있는 경우에만 수집기를 실행합니다.

수집을 시작하고 문제를 재현한 다음 수집을 중지합니다. Visual Studio Ultimate에서.iTrace 파일을 열고 데이터를 검사합니다. Open the IntelliTrace log file in Visual Studio Ultimate.을 참조하십시오.
웹 앱 및 SharePoint 응용 프로그램의 경우 수집기는 지정한 응용 프로그램 풀을 공유하는 모든 앱에 대한 데이터를 기록합니다. 수집 계획에서는 단일 앱에 대한 모듈만 지정할 수 있지만, 이로 인해 같은 응용 프로그램 풀을 공유하는 앱의 속도가 느려질 수 있습니다.

수집기로 인해 다른 앱의 속도가 느려지지 않도록 하려면 자체 응용 프로그램 풀에서 각 앱을 호스트합니다.
IntelliTrace가 데이터를 수집하는 이벤트를 수집 계획에서 검토합니다. 수집 계획을 편집하여 관련이나 필요가 없는 이벤트를 사용하지 않도록 설정합니다.

이벤트를 사용하지 않도록 설정하려면 enabled 요소의 <DiagnosticEventSpecification> 특성을 false로 설정합니다.

<DiagnosticEventSpecification enabled="false">

enabled 특성이 없으면 이벤트는 사용하도록 설정됩니다.

이러한 방법을 통해 성능을 개선하는 방식
- 앱에 관련이 없는 이벤트를 사용하지 않도록 설정하여 시작 시간을 단축할 수 있습니다. 예를 들어 Windows 워크플로를 사용하지 않는 앱에 대해 Windows 워크플로 이벤트를 사용하지 않도록 설정합니다.
- 레지스트리에 액세스하기는 하지만 레지스트리 설정에 문제가 표시되지 않는 앱에 대해 레지스트리 이벤트를 사용하지 않도록 설정하면 시작 및 런타임 성능을 모두 개선할 수 있습니다.
IntelliTrace가 데이터를 수집하는 모듈을 수집 계획에서 검토하고, 다음 단계를 수행하여 관련이 있는 모듈만 포함하도록 수집 계획을 편집합니다.
1. 수집 계획을 엽니다. <ModuleList> 요소를 찾습니다.
2. <ModuleList>에서 isExclusionList 특성을 false로 설정합니다.
3. <Name> 요소를 사용하여 파일 이름, 문자열 값(이름에 해당 문자열이 들어 있는 모듈이 포함됨) 또는 공개 키 중 하나로 각 모듈을 지정합니다.
예를 들어 Fabrikam Fiber 웹 앱의 기본 웹 모듈에서만 데이터를 수집하려면 다음과 같은 목록을 만듭니다.
```
<ModuleList isExclusionList="false">
   <Name>FabrikamFiber.Web.dll</Name>
</ModuleList>
```
이름에 "Fabrikam"이 포함되어 있는 모든 모듈에서 데이터를 수집하려면 다음과 같은 목록을 만듭니다.
```
<ModuleList isExclusionList="false">
   <Name>Fabrikam</Name>
</ModuleList>
```
공개 키 토큰을 지정하여 모듈에서 데이터를 수집하려면 다음과 같은 목록을 만듭니다.
```
<ModuleList isExclusionList="false">
   <Name>PublicKeyToken:B77A5C561934E089</Name>
   <Name>PublicKeyToken:B03F5F7F11D50A3A</Name>
   <Name>PublicKeyToken:31BF3856AD364E35</Name>
   <Name>PublicKeyToken:89845DCD8080CC91</Name>
   <Name>PublicKeyToken:71E9BCE111E9429C</Name>
</ModuleList>
```
이러한 방법을 통해 성능을 개선하는 방식

이 작업을 수행하면 앱이 시작되어 실행될 때 IntelliTrace가 수집하는 메서드 호출 정보 및 기타 계측 데이터의 양을 줄일 수 있습니다. 이 데이터를 통해 다음 작업을 수행할 수 있습니다.
- 데이터 수집 후 코드를 단계별로 실행합니다.
- 함수 호출에서 전달 및 반환된 값을 검사합니다.
모듈을 제외하지 않는 이유

기본적으로 수집 계획에서는 isExclusionList 특성을 true로 설정하여 모듈을 제외합니다. 그러나 모듈을 제외해도 목록 기준을 충족하지 않으며 관련이 없는 모듈(예: 타사 또는 오픈 소스 모듈)에서 데이터가 수집될 수 있습니다.
IntelliTrace에서 수집하지 않는 데이터

성능에 대한 영향을 줄이기 위해 IntelliTrace는 데이터 수집 시 메서드에서 전달 및 반환되는 기본 데이터 형식의 값과 메서드에서 전달 및 반환되는 최상위 개체의 필드에 포함된 기본 데이터 형식의 값만 수집합니다.

예를 들어 AlterEmployee 메서드 서명이 정수 id 및 Employee 개체 oldemployee를 허용한다고 가정해 보겠습니다.

public Employee AlterEmployee(int id, Employee oldemployee)

Employee 형식에는 Id, Name 및 HomeAddress 특성이 있습니다. 그리고 Employee 및 Address 형식 간에는 연결 관계가 있습니다.

수집기는 id 메서드에서 반환되는 Employee.Id, Employee.Name, Employee 및 AlterEmployee 개체의 값을 기록합니다. 그러나 Address 개체에 대한 정보는 null인지 여부를 제외하고는 기록하지 않습니다. 또한 AlterEmployee 메서드의 로컬 변수에 대한 데이터도 기록하지 않습니다. 단, 다른 메서드가 해당 로컬 변수를 매개 변수로 사용하는 경우에는 로컬 변수가 메서드 매개 변수로 기록됩니다.