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:
Using either in-code attributes or extended attributes, add
PerformanceProbeAttribute
s to the appropriate methods.Configure the properties of these attributes appropriately.
Build your Dotfuscator config.
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:
Using either an in-code attribute or an extended attribute, add a
SystemProfileAttribute
to the appropriate method.Configure the properties of this attribute appropriately.
Build your Dotfuscator config.
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.