PreEmptive Protection - Dotfuscator 4.31
User Guide

System Metrics

Dotfuscator provides several features for reporting system metrics from an injected application. If the Session Tracking feature is being used, then the Session Start message includes the .NET Runtime version and some basic OS information. For when more detailed metrics are desired, Dotfuscator provides the Performance Metrics Reporting feature and the System Profile Reporting feature for reporting information about the system on which the injected application is running.

Performance Metrics Reporting

This feature can be used to gather and send performance-related information while the injected application is executing.

Configuration

To report performance metrics of the injected application:

  1. Configure your application to track sessions.

  2. Using either in-code attributes or extended attributes, add PerformanceProbeAttributes to the appropriate methods.

  3. Configure the properties of these attributes appropriately.

  4. Build your Dotfuscator project.

The output assemblies will now contain injected code for reporting performance metrics.

Supported Application Types

Performance Metrics Reporting can be used on methods within all assemblies supported by instrumentation.

Performance Metrics Message

Generated when a method annotated with PerformanceProbeAttribute executes and the user has not opted-out.

Includes the following data:

  • Session ID
  • Timestamp
  • CPU Utilization
  • Memory available
  • Memory used by current process
  • Extended Keys if configured

System Profile Reporting

This feature can be used to gather and send information about the system on which the application is running. Typically this data only needs to be collected once during an application run.

Configuration

To report the system profile:

  1. Configure your application to track sessions.

  2. Using either an in-code attribute or an extended attribute, add a SystemProfileAttribute to the appropriate method.

  3. Configure the properties of this attribute appropriately.

  4. Build your Dotfuscator project.

The output assemblies will now contain injected code for reporting the system profile.

Supported Application Types

System Profile Reporting can be used on methods within all assemblies supported by instrumentation.

System Profile Message

Generated when a method annotated with SystemProfileAttribute executes and the user has not opted-out.

Below is a high-level description of the kind of system data that is gathered:

Category Examples of Collected Data
Processors Number of processors, clock speeds, manufacturer, and processor ID.
Logical Disks Number of logical disks, volume name, size, free space, file system
Memory Speed, capacity
Network Adapters IP address, MAC address
Domain Domain name and role
Display Name, refresh rate, vertical and horizontal resolution
Video Name, memory size, color depth
Terminal Services Connections allowed
Sound Name, manufacturer
Modem Model, device type

In addition, Extended Keys, if configured, will be sent with the message.

Dotfuscator Version 4.31.0.6091. Copyright © 2017 PreEmptive Solutions, LLC