PreEmptive Protection - Dotfuscator
Community Edition

Exception Tracking

Exception Tracking is a form of Analytics that allows an injected application to report when unhandled exceptions occur.

Note: Dotfuscator Professional Edition also allows you to track exceptions caught by your application and exceptions thrown by your application.

Configuration

To track exceptions:

  1. Configure your application to track sessions.
  2. Using either in-code attributes or extended attributes, add ExceptionTrackAttributes to appropriate assemblies and methods.
  3. Configure the properties of these attributes appropriately.
  4. Build your Dotfuscator project.

The output assemblies will now contain injected code for exception tracking.

Supported Application Types

Exception tracking can be used on methods within all assemblies supported by analytics. Exception tracking can also be used on those assemblies themselves except for the following cases:

Note that if you are injecting the Generic Exception Dialog, then additional restrictions apply.

Report Info

When an exception occurs, it may be helpful for the user to provide additional information, such as what scenario triggered the error. Additionally, the user may consent to sending an exception report even if they previously opted-out of Analytics. You can have your application provide this information, or you can have the injected code ask the user for the information.

Application Provided

This information is communicated via a source defined with the ExceptionTrackAttribute called ReportInfoSource. The source defines either an IDictionary or an IDictionary<string,string>. There are three keys that the injected code will look up in this dictionary:

  • "consent": value is the string "true" or "false", indicating whether the user opted-in to transmitting this exception report.
    • If "true", the exception report will always be sent, even if the user opted-out of Analytics.
    • If "false" (or any other string), the exception report will never be sent, even if the user opted-in to Analytics.
    • If not specified, the general Analytics opt-in preference will be honored.
  • "comment": value is a user-provided comment about what the application was doing when the exception occurred.
    • If specified, this information will be included in the fault message.
  • "contact": value is a user-provided piece of contact information.
    • If specified, this information will be included in the fault message.

Generic Exception Dialog

Dotfuscator can have the injected code ask the user for information, instead of calling out to application code. To do this, on the ExceptionTrackAttribute's ReportInfoSourceElement property, choose the "DefaultAction" value.

Behavior

This dialog will use the following information, if provided:

The user can provide additional details (the comment and contact information) by clicking the Add Details button. If they click the Send Error Report button, the report will be sent. If they close the dialog in any other way, the report will not be sent. The general Analytics opt-in preference will be ignored in all cases.

Dialog-compatible Application Types

The generic exception dialog can be used on assemblies supported by exception tracking, and methods within those assemblies, except for the following:

  • .NET Compact Framework assemblies
  • Windows Phone assemblies
  • Universal Windows Platform (UWP) assemblies

Additionally, in a Silverlight assembly, the generic exception dialog can only be used for assembly-level exception tracking; it cannot be used for method-level tracking.

Messages

Exception tracking only generates one type of message: Fault.

Fault

Generated when an unhandled exception is detected in the assembly or method annotated with an ExceptionTrackAttribute and the user consents to it being sent.

Includes the following data:

  • Session ID
  • Timestamp
  • Exception type
  • Exception message
  • Exception stack trace
  • List of loaded assemblies
  • Comment and contact information, if provided


Dotfuscator Version 5.27.0.4687. Copyright © 2017 PreEmptive Solutions, LLC