{"id":6253,"date":"2011-09-15T14:25:00","date_gmt":"2011-09-15T14:25:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudioalm\/2011\/09\/15\/modifying-an-intellitrace-collection-plan-for-the-stand-alone-collector\/"},"modified":"2022-07-27T05:26:11","modified_gmt":"2022-07-27T13:26:11","slug":"modifying-an-intellitrace-collection-plan-for-the-stand-alone-collector","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/modifying-an-intellitrace-collection-plan-for-the-stand-alone-collector\/","title":{"rendered":"Modifying an IntelliTrace Collection Plan for the Stand-Alone Collector"},"content":{"rendered":"

With the release of the CTP of Visual Studio vNext we are including the ability to collect IntelliTrace logs from web applications running in IIS 7.0 and 7.5 without requiring Visual Studio installed on the web server.<\/span><\/span><\/p>\n

Several demos exist of the stand-alone Intellitrace data collector including one by Cameron Skinner and Brian Keller at TechEd earlier this year and another by Tracey Trewin and Mark Groves at the \/\/BUILD\/ conference.\u00a0 Recordings of these sessions are available.<\/span><\/span><\/p>\n

What you get out of the box<\/span><\/span><\/span><\/h2>\n

<\/span><\/span>\u00a0<\/p>\n

The stand-alone Intellitrace data collector .cab \u00a0install file is available with the CTP release of Visual Studio.\u00a0 With a default installation the file is located at c:Program Files(x86)Microsoft Visual Studio 11.0Team ToolsTraceDebugger ToolsIntelliTraceCollection.cab<\/span><\/span><\/p>\n

Included with the cab are two collection plans, collection_plan.ASP.NET.trace.xml and collection_plan.ASP.NET.default.xml.\u00a0 The collection_plan.ASP.NET.default.xml\u00a0 collection plan equates to the default IntelliTrace setting in Visual Studio, including which events are enabled and which are not. The collection_plan.ASP.NET.trace.xml collection plan is the same as selecting \u201cIntelliTrace events and call information\u201d from the General tab of the IntelliTrace options in Visual Studio.<\/span><\/span><\/p>\n

The details of these settings are available on MSDN. For more information, see \u00a0<\/span><\/span>Collecting IntelliTrace Data By Using the Stand-Alone Collector<\/a>.<\/p>\n

Modifying the Collection Plan<\/span><\/span><\/span><\/h2>\n

Just as you are likely to make modifications to the IntelliTrace settings in Visual Studio you may want to modify the collection settings when using the files from the cab.\u00a0 The easiest way to think of this is by looking at the options in Visual Studio and then making the equivalent change in the collection plan xml file that you wish to use with your application. <\/span><\/span><\/p>\n

Log file size is controlled by the MaximumLogFileSize as measured in 64kb blocks.\u00a0 The default is 4000 which equates to a 256MB log file.<\/span><\/span><\/p>\n

Each of the events listed in the Visual Studio options matches to a DiagnosticEventSpecification in the xml.\u00a0 For example the event \u201cProcess Request (IIS)\u201d<\/span><\/span><\/p>\n

\"\"<\/p>\n

matches the DiagnosticEventSpecification as shown.<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>system.web<\/CategoryId><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<SettingsName\u00a0_locID<\/span>=”settingsName.HttpApplication.AssignContext”><\/span>Process\u00a0Request\u00a0(IIS)<\/SettingsName><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<SettingsDescription\u00a0_locID<\/span>=”settingsDescription.HttpApplication.AssignContext”><\/span>Asynchronous\u00a0call\u00a0to\u00a0an\u00a0HTTP\u00a0handler\u00a0initialized.<\/SettingsDescription><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>system.web<\/ModuleSpecificationId><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>System.Web.HttpApplication<\/TypeName><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>AssignContext<\/MethodName><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>System.Web.HttpApplication.AssignContext(System.Web.HttpContext):System.Void<\/MethodId><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<ShortDescription\u00a0_locID<\/span>=”shortDescription.HttpApplication.AssignContext”>{0}\u00a0“{1}”<\/ShortDescription><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<LongDescription\u00a0_locID=”<\/span>longDescription.HttpApplication.AssignContext“>Asynchronous\u00a0call\u00a0to\u00a0an\u00a0HTTP\u00a0handler\u00a0initialized.<\/LongDescription><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<DataQuery\u00a0index<\/span>=”1″\u00a0maxSize<\/span>=”256″\u00a0type<\/span>=”String”\u00a0name<\/span>=”Request\u00a0HTTP\u00a0Method”\u00a0_locID<\/span>=”dataquery.HttpApplication.AssignContext.RequestHTTPMethod”\u00a0_locAttrData<\/span>=”name”\u00a0query=”_request._httpMethod”><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/DataQuery><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<DataQuery\u00a0index<\/span>=”1″\u00a0maxSize<\/span>=”256″\u00a0type<\/span>=”String”\u00a0name<\/span>=”Request\u00a0file\u00a0path”\u00a0_locID=”dataquery.HttpApplication.AssignContext.Requestfilepath”\u00a0_locAttrData<\/span>=”name”\u00a0query<\/span>=”_request._clientFilePath._virtualPath”><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/DataQuery><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/DataQueries><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/Binding><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/Bindings><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/DiagnosticEventSpecification><\/span><\/p>\n

Ok, so that\u2019s a lot of XML behind a simple setting in Visual Studio.\u00a0 However if all you want to do is either turn it on or off (just like checking the checkbox in Visual Studio) all you need to do is work with a single xml attribute.\u00a0 For each DiagnosticEventSpecification there is a single attribute controling whether the event is collected.\u00a0 It is the \u201cenabled\u201d attribute on the DiagnosticEventSpecification element.\u00a0 But wait, you say, there is no such attribute on the DiagnosticEventSpecification element in the sample!\u00a0 True enough, if the attribute is omitted the default behavior is to collect that event.\u00a0 In the example above the following two DiagnosticEventSpecification elements would be considered equal.<\/span><\/span><\/p>\n

<\/span><\/p>\n

<\/span><\/p>\n

If you do not want to collect a specific event you can disable it by setting the enabled attribute to false like this:<\/span><\/span><\/p>\n

<\/span><\/p>\n

Note:<\/b><\/em> To collect any events at all you must also ensure that the DiagnosticEventInstrumentation element has the attribute \u201cenabled\u201d set to true.\u00a0 You can think of this element is the master control for all of the events and determines whether they are collected or not regardless of the enabled setting on any individual DiagnosticEventSpecification.<\/em><\/span><\/p>\n

If you compare the two collection plans that are provided with the cab file you will see that the only difference between the two of them is element that controls the difference between Events Only collection and Events and Call Information.\u00a0 The element is<\/span><\/span><\/p>\n

<\/span><\/p>\n

Setting the enabled attribute to true on the TraceInstumentation element enables the collection of call information.<\/span><\/span><\/p>\n

As you can see the enabled attribute is used to control much of the collection capabilities of IntelliTrace.<\/span><\/span><\/p>\n

The next section to look at is the ModuleList found nested within the TraceInstrumentation element.<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 =”true”><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>PublicKeyToken:B77A5C561934E089<\/Name><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>PublicKeyToken:B03F5F7F11D50A3A<\/Name><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>PublicKeyToken:31BF3856AD364E35<\/Name><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>PublicKeyToken:89845DCD8080CC91<\/Name><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>PublicKeyToken:71E9BCE111E9429C<\/Name><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>Microsoft.<\/Name><\/span><\/p>\n

\u00a0\u00a0\u00a0 <\/ModuleList><\/span><\/p>\n

This section maps to the Modules section of the options in Visual Studio. The isExclusionList attribute maps to the selection between \u201cCollect data from all modules except for the following\u201d option and the \u201cCollect data from only the following modules\u201d option.\u00a0 It is important to note that this only applies to the collection of call data and does not apply to the IntelliTrace events.<\/span><\/span><\/p>\n

\u00a0<\/span><\/p>\n

The default behavior is to use a \u201cblack list\u201d approach in which the listed modules are excluded from call data instrumentation.\u00a0 The public key that are listed represent Microsoft keys.\u00a0 Therefore the list will generally not instrument any of the Microsoft modules that may contribute to your application.<\/span><\/span><\/p>\n

Often it may be advantageous to only instrument specific modules by using a \u201cwhite list\u201d approach in which the specific modules are listed explicitly.\u00a0 This will keep call information collection more focused on just the modules of interest.\u00a0 This is also an easier way to eliminate third party modules that may be consumed by your application.\u00a0 To target only the modules that represent the Fabrikam code for an application the module list might look like the following:<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 =”false”><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>Fabrikam.<\/Name><\/span><\/p>\n

\u00a0\u00a0\u00a0 <\/ModuleList><\/span><\/p>\n

Using this configuration will eliminate any module that does not have the string \u201cFabrikam.\u201d in the module file name.\u00a0 This will keep collection of call information tightly scoped to only the modules of interest which will improve collection performance when including call data.<\/span><\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

With the release of the CTP of Visual Studio vNext we are including the ability to collect IntelliTrace logs from web applications running in IIS 7.0 and 7.5 without requiring Visual Studio installed on the web server. Several demos exist of the stand-alone Intellitrace data collector including one by Cameron Skinner and Brian Keller at […]<\/p>\n","protected":false},"author":124,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[226,1,225],"tags":[],"class_list":["post-6253","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ci","category-devops","category-git"],"acf":[],"blog_post_summary":"

With the release of the CTP of Visual Studio vNext we are including the ability to collect IntelliTrace logs from web applications running in IIS 7.0 and 7.5 without requiring Visual Studio installed on the web server. Several demos exist of the stand-alone Intellitrace data collector including one by Cameron Skinner and Brian Keller at […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/6253","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/124"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=6253"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/6253\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=6253"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=6253"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=6253"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}