Analytics

  • 아티클

Dd551422.collapse(ko-kr,VS.110).gifDd551422.expand(ko-kr,VS.110).gifDd551422.copycode(ko-kr,VS.110).gifDd551422.copycodeHighlight(ko-kr,VS.110).gifDd551422.drpdown(ko-kr,VS.110).gifDd551422.drpdown_orange(ko-kr,VS.110).gif
PreEmptive Dotfuscator and Analytics Community Edition 5.5
Analytics
www.preemptive.com

Glossary Item Box

Analytics에서는 추가 코드 없이 사전 빌드된 응용 프로그램 사용 추적, 예외 보고, 이진 변경 검색 및 응용 프로그램 만료를 응용 프로그램에 삽입합니다. Dotfuscator and Analytics는 사용자에게 필요한 코드를 삽입합니다. 소스 코드의 사용자 지정 특성 또는 Dotfuscator and Analytics 사용자 인터페이스에 지정된 확장 특성을 통해 삽입 지점을 정의할 수 있습니다.

Analytics 편집기에서 확장된 사용자 지정 특성을 추가하거나 편집하고 검토할 수 있습니다. Dotfuscator and Analytics CE의 경우 Analytics 편집기에는 시작 탭, 특성 탭, 옵션 탭의 세 가지 구성 탭이 표시됩니다. 시작 탭에서는 사용 가능한 다양한 분석 옵션 그리고 해당 옵션을 구성하는 방법에 대해 설명합니다. 특성 탭에서는 새 확장 특성을 메서드에 추가하거나 이미 있는 사용자 지정 특성을 수정할 수 있습니다. 옵션 탭에서는 Runtime Intelligence Service로 전송할 응용 프로그램 분석, 보존 기간 알림 및 변경 알림과 같은 유형의 메시지를 선택할 수 있습니다.

Assembly 특성

Assembly 특성은 어셈블리 수준에서만 적용 가능한 특성입니다. Assembly 특성은 회사 정보와 같은 고유한 식별 데이터를 어셈블리에 추가하기 위해 또는 전체 어셈블리에서 예외를 추적하기 위해 코드 삽입 프로세스에서 사용됩니다.

Dd551422.addattribute(ko-kr,VS.110).png

필수 Assembly 특성

Runtime Intelligence Services용 응용 프로그램을 계측하려면 두 가지 Assembly 특성이 필요합니다. 수정할 특성 선택: 트리에서 어셈블리 노드를 마우스 오른쪽 단추로 클릭하면 이러한 필수 특성이 응용 프로그램에 추가됩니다.

BusinessAttribute

필수 특성인 BusinessAttribute에는 계측되는 응용 프로그램을 소유한 회사를 식별하는 데 사용되는 값이 포함되어 있습니다. 이 특성은 CompanyKey로 구성되며 이 값은 무료 Runtime Intelligence Services 포털과 함께 사용할 "7d2b02e0-064d-49a0-bc1b-4be4381c62d3"으로 설정되어야 합니다. 편의를 위해 CompanyKey는 기본적으로 이 GUID로 설정되어 있습니다. 다른 끝점을 대상으로 지정할 경우 PreEmptive Solutions에서 제공하는 CompanyKey를 사용하거나, CompanyKey 항목 영역과 연결된 "..." 단추를 눌러 새 고유 식별자를 생성하십시오. CompanyName은 비워 둘 수 있지만 Runtime Intelligence Services 포털 개인 설정을 위해 회사 이름을 입력하는 것이 좋습니다.

ApplicationAttribute

필수 특성인 ApplicationAttribute에는 계측되는 응용 프로그램을 식별하는 데 사용되는 다음과 같은 값이 포함되어 있습니다.

  • ApplicationType. Windows 응용 프로그램 등의 계측되는 응용 프로그램 형식을 식별합니다. 
  • GUID. 이 필드에서 "..."을 클릭하여 생성하는 해당 응용 프로그램에 대한 고유 식별자입니다. 
  • Name. 응용 프로그램 이름입니다. 비워 두면 런타임에 리플렉션이 허용되는 경우 리플렉션을 통해 이 항목이 채워집니다. 어셈블리 이름과 다른 포털 이름을 원하는 경우 또는 Silverlight 응용 프로그램과 같이 런타임에 응용 프로그램에서 리플렉션을 사용할 수 없는 경우에만 입력합니다.
  • Version. 응용 프로그램 버전입니다. 비워 두면 런타임에 리플렉션이 허용되는 경우 리플렉션을 통해 이 항목이 채워집니다. 어셈블리 버전과 다른 포털 버전을 원하는 경우 또는 Silverlight 응용 프로그램과 같이 런타임에 응용 프로그램에서 리플렉션을 사용할 수 없는 경우에만 입력합니다.

BinaryAttribute

BinaryAttribute에는 계측되는 응용 프로그램을 구성하는 특정 어셈블리를 식별하는 데 사용되는 값이 포함되어 있습니다. GUID는 어셈블리의 고유 식별자이며 변경이 검색될 때 변경할 어셈블리를 지정하는 데 사용됩니다.이 특성은 필수 특성은 아니지만 변경 검색을 사용하는 경우 알림에 어셈블리 정보를 포함할 수 있도록 각 어셈블리의 이진 특성을 설정해야 합니다.

ExceptionTrackAttribute(어셈블리 수준)

ExceptionTrackAttribute는 어셈블리 및 메서드 수준 모두에서 처리되지 않은 예외를 추적하는 데 사용됩니다. 어셈블리 수준 ExceptionTrackAttribute는 어셈블리 내 어디에서나 발생하는 예외를 감지하는 데 사용될 수 있습니다. Dotfuscator and Analytics에서는 ExceptionTrackAttribute가 발생할 때 현재 AppDomain(.NET Framework 응용 프로그램의 경우) 또는 현재 Application(Silverlight 응용 프로그램의 경우)에 UnhandledException 이벤트 처리기를 등록함으로써 처리되지 않은 예외를 감지하는 코드를 추가합니다. 기본 제공 또는 사용자 지정 예외 대화 상자를 통해 명시적인 예외 보고서 옵트인을 설정할 수 있으며, 이는 개인정보취급방침 URI를 표시하고 최종 사용자 연락처 정보 또는 최종 사용자가 작성한 예외 발생 상황에 대한 정보를 수집할 수도 있습니다.

Functional 특성

Functional 특성은 응용 프로그램 안정성, 기능 사용, 변경 시도 및 응용 프로그램 사용 빈도를 추적하는 데 사용할 수 있습니다. 또한 일정 기간 후에 응용 프로그램이 작동을 중단하도록 하는 데에도 사용할 수 있습니다.

SetupAttribute

SetupAttribute를 사용하여 응용 프로그램이 시작된 시기를 추적할 수 있습니다. Dotfuscator and Analytics에서는 메시지 전송을 위해 시작 코드를 삽입하고 시작 메시지를 전송합니다. Runtime Intelligence를 사용하는 어셈블리 또는 응용 프로그램에는 이 특성을 가진 메서드가 하나 이상 필요합니다. 이 특성은 일반 응용 프로그램 시작 논리에 최대한 가깝게 배치해야 합니다. 런타임에 이 특성에서 생성된 기능은 사용 데이터를 Runtime Intelligence Services 포털로 다시 전송하는 작업을 시작합니다. 선택적으로 메시지 전송을 제어하는 기능(옵트인 또는 옵트아웃 동작)의 코드에 위치를 지정할 수도 있습니다. Dotfuscator and Analytics는 초기화 코드를 생성할 때 이 정보를 사용합니다.

SetupAttribute를 추가할 때 메시지의 사용자 지정 끝점 대상을 설정할 수 있습니다. 끝점 옵션에는 무료 Runtime Intelligence Services 포털(기본값),상업용으로 사용 가능한 Runtime Intelligence Services 포털 또는 자체적으로 선택한 사용자 지정 끝점이 포함됩니다.

Dd551422.select_endpoint(ko-kr,VS.110).png

SetupAttribute는 또한 응용 프로그램 내에 옵트인 또는 옵트아웃 기능을 구현하는 기능을 제공합니다. 사용자는 이 기능을 통해 사용 데이터 제공 여부를 선택할 수 있습니다. 실행 및 사용 데이터를 수집하여 Runtime Intelligence Services 포털로 전송할지 여부를 결정하는 설정을 제공하기 위해 부울 값을 포함하거나 반환하는 메서드, 메서드 인수, 필드 또는 속성을 지정할 수 있습니다. 값이 true인 경우 응용 프로그램은 구성된 대로 사용 데이터를 전송합니다. 값이 false인 경우 응용 프로그램에서 사용 데이터를 전송하지 않습니다.

Dd551422.instrumentation_setupattribute(ko-kr,VS.110).png

옵트인 또는 옵트아웃 동작을 구성하려면 부울 값을 포함하는 적절한 유형의 코드 요소로 OptInSourceElement 속성을 구성해야 합니다. OptInSourceName은 Runtime Intelligence 데이터를 수집하여 전송할지 여부를 결정하는 데 사용되는 부울 값이 들어 있는 요소의 이름이어야 합니다. 런타임에 설정 메서드가 호출되기 전에 응용 프로그램 코드에서 소스 값을 설정해야 합니다. SetupAttribute로 특성이 지정된 메서드와 동일한 클래스에 요소가 정의된 경우 OptInSourceOwner 속성은 해제될 수 있습니다. OptInSourceElement가 메서드 인수인 경우 이는 SetupAttribute로 주석 처리된 메서드의 메서드 매개 변수와 일치해야 합니다.

TeardownAttribute

TeardownAttribute를 사용하여 응용 프로그램이 중지된 시기를 추적할 수 있습니다. Dotfuscator and Analytics에서는 메시지 전송을 위해 해체 코드를 삽입하고 종료 메시지를 전송합니다. Runtime Intelligence 분석을 사용하는 어셈블리 또는 응용 프로그램에 이 특성을 가진 메서드가 하나 이상 필요합니다. 해체 메서드가 가장 나중에 호출되는 메서드일 필요는 없지만 응용 프로그램이 종료될 때 바로 실행되도록 최대한 끝내기에 가까운 속성을 가져야 합니다.

FeatureAttribute

FeatureAttribute는 Runtime Intelligence Service를 사용하여 추적할 기능에 태그를 지정합니다. 이 특성은 메서드 또는 속성에 배치될 수 있습니다. Runtime Intelligence는 이 속성에 제공된 이름을 사용하여 기능을 추적합니다. 여러 메서드에 동일한 이름이 부여되면 Runtime Intelligence Services 포털에 있는 동일한 사용 표시기가 업데이트됩니다. 추적 대상 기능은 기본 이벤트 또는 측정 가능한 실행 기간이 될 수 있습니다. 실행된 기능을 간단히 추적하려면 FeatureEventType의 'Tick'을 사용하십시오. 기능의 실행 기간을 측정하려면 동일한 이름을 가진 두 기능 특성을 사용하십시오. 하나는 FeatureEventType의 'Start'이고 다른 하나는 FeatureEventType의 'Stop'입니다. 포털의 기능 점수 보고서에서 각 기능 실행에 대한 최소, 최대 및 평균 기간을 확인할 수 있습니다. 

InsertShelfLifeAttribute

InsertShelfLifeAttribute를 응용 프로그램 만료 확인을 수행할 속성 또는 메서드에 추가합니다. 런타임에 만료 날짜 이후에 응용 프로그램이 실행되면 응용 프로그램에서는 만료 알림 메시지를 Runtime Intelligence Services 포털로 보냅니다. 만료 시 기본 동작은 만료 알림 메시지를 보내는 것입니다. 하지만 ExpirationNotificationSinkElement 속성을 DefaultAction으로 설정하여 선택적으로 만료 메시지를 Runtime Intelligence Services 포털로 전송하면 응용 프로그램이 바로 끝나도록 할 수도 있습니다. 만료 알림 메시지를 전송하려면 응용 프로그램에 Setup 및 Teardown 특성이 표시된 메서드를 포함해야 합니다.

이 기능으로 응용 프로그램을 계측하려면 SLAK(Shelf Life Activation Key)가 필요합니다. SLAK를 가져오려면 지원 사이트(http://www.preemptive.com/support/index.html)로 이동하십시오.

InsertSignofLifeAttribute

InsertSignofLifeAttribute는 이 특성으로 태그가 지정된 메서드가 호출될 때마다 메시지를 보냅니다. 런타임에 기간 표시 코드에서는 응용 프로그램이 실행되었음을 나타내는 메시지를 보냅니다. 이 특성을 사용하려면 응용 프로그램에 Setup 및 Teardown 특성이 표시된 메서드를 포함해야 합니다.

이 기능으로 응용 프로그램을 계측하려면 SLAK(Shelf Life Activation Key)가 필요합니다. SLAK를 가져오려면 지원 사이트(http://www.preemptive.com/support/index.html)로 이동하십시오.

InsertTamperCheckAttribute

InsertTamperCheckAttribute는 사용자가 어셈블리를 수정했는지 검색하는 코드를 삽입합니다. 어셈블리 변경이 검색되면 변경 알림 메시지를 Runtime Intelligence Services 포털로 보냅니다. 검색 시 기본 동작은 변경 알림 메시지를 보내고 응용 프로그램을 끝내는 것입니다. 하지만 ApplicationNotificationSinkElement 속성을 DefaultAction으로 설정하여 응용 프로그램이 바로 끝나도록 할 수도 있습니다. Runtime Intelligence 변경 메시지를 보내려는 경우 Setup 특성을 포함하는 동일한 메서드에 이 특성을 넣지 마십시오. 또한 변경 확인 특성이 표시된 메서드가 Setup 특성을 포함하는 메서드 다음에 실행되는지 확인하십시오.

ExceptionTrackAttribute(메서드 수준)

메서드 수준 ExceptionTrackAttribute는 특정 메서드를 전달하는 로컬에서 처리되지 않은 예외를 감지하는 데 사용될 수 있습니다. Dotfuscator and Analytics에서는 메서드 수준 ExceptionTrackAttribute가 발생할 때 try/catch 블록에 메서드를 래핑하고 예외를 다시 throw하는 코드를 추가합니다. 메서드 수준 ExceptionTrackAttribute는 어셈블리 수준 ExceptionTrackAttribute와 동일한 옵트인 및 추가 정보를 수집할 수 있습니다. 

analytics 옵션

Analytics 옵션 탭에서는 계측된 응용 프로그램의 동작을 구성할 수 있습니다. PreEmptive Analytics 특성 처리 확인란을 선택 취소하거나 탐색 트리의 Analytics를 마우스 오른쪽 단추로 클릭한 다음 설정 옵션을 선택 취소하여 현재 프로젝트에 대해 응용 프로그램의 계측(코드 삽입)을 설정하거나 해제할 수 있습니다. 이 사용 옵션을 선택 취소한 경우 프로젝트가 빌드될 때 Dotfuscator에서 코드 삽입을 수행하지 않습니다.

Dd551422.Instrumentation_Options(ko-kr,VS.110).png

이 탭의 Runtime Intelligence 구성 섹션에서는 Runtime Intelligence Services 포털로 보낼 메시지 유형을 선택할 수 있습니다. 응용 프로그램 분석 메시지 보내기 옵션에서는 기능 사용과 관련된 메시지 보내기를 설정할 수 있습니다. 보존 기간 알림 메시지 보내기 옵션에서는 보존 기간 만료 및 기간 표시 메시지 보내기를 설정할 수 있습니다. 변경 알림 메시지 보내기 메시지 옵션에서는 변경 알림 메시지 보내기를 설정할 수 있습니다. 보존 기간 또는 변경 메시지 옵션을 선택 취소하면 해당 메시지 전송에만 영향을 미치며 DefaultAction 발생을 선택했다면 응용 프로그램은 여전히 예상대로 끝납니다.

참고 항목

PreEmptive Solutions 지원

 

 

© 2002-2012 PreEmptive Solutions. All rights reserved.