Dotfuscator User's Guide
Instrumentation (Tamper, Shelf Life, Exception, Analytics)

The Instrumentation Tab allows you to add, edit, and review the custom attributes that configure Dotfuscator's code-injection features (called Instrumentation).  Those features include:

For new projects, the default setting for the Instrumentation transform is Enabled.

Supported custom attributes already in your source code can be edited through the user interface. Changes are persisted to the Dotfuscator configuration file and take precedence over the attributes in source code.

Extended custom attributes can also be added and edited through the user interface. Dotfuscator treats extended attributes the same as it treats custom attributes embedded in the source code.

You can also map supported attributes (even attributes embedded in code) to a particular supported code transform. This supports attribute overloading, wherein the same set of attributes can drive multiple transforms (e.g. Application Analytics).

To add an attribute, navigate to the method or assembly you wish to place the attribute on and select it. If the attribute has arguments, you will be able to set them in the instrumentation editor.

Checking the Analytics checkbox in the Transforms to trigger off the attribute: section instruments the attributed method as a feature to be tracked with PreEmptive Analytics.

Custom Endpoint

In the Attribute Editor for the SetupAttribute, the StaticEndpoint field is where you explicitly specify the endpoint for PreEmptive Analytics messages.  If no custom endpoint is selected, PreEmptive's commercial endpoint will be used.  Click the "..." (ellipses) in the StaticEndpoint field to invoke the Select Endpoint window:

Here you are able to specify what endpoint you wish to send to.  Once you've made your selection and clicked OK, the location displays in the StaticEndpoint field:

Attribute Search Field

The Instrumentation tab is enabled with a Find feature that enables you to easily locate any item in the instrumentation tree view. You may type the full name or the first few letters of any item you wish to find in the Select the attribute to modify: field then click Find. You may also search for an item by typing .* (the wildcard) after the first few letters of the name, or you may enter a Regular Expression.  Dotfuscator will select the first item where your search term appears.  Clicking on the Find button will select the next match for your search term. Please note that since the search matches the beginning of an item's name,  when searching for instrumentation attributes you will need to search using the full name of the attribute.  For example, to find a setup attribute, enter PreEmptive.Attributes.SetupAttribute.

See Also




© 2016 PreEmptive Solutions, LLC. All Rights Reserved.