Netwrix Activity Monitor Integration
Netwrix Change Tracker can use the Netwrix Activity Monitor (via its SBTService Windows
service, which appears as Netwrix Windows File Monitoring Service in services.msc) as an
alternative data source for file change attribution on Windows. When you enable this integration,
the Gen 7 Agent reads user and process information from log files that Activity Monitor produces
instead of relying on the built-in kernel mini-filter driver (NNTInfo.sys).
This is useful in environments where the kernel driver can't load, for example systems with strict kernel security policies (Secure Boot / HVCI), certain hypervisor configurations, or where you already deploy Activity Monitor and want a single audit trail for file activity.
This feature applies to Windows only and to file integrity monitoring (FIM) with live tracking. This feature doesn't affect Linux devices.
Prerequisites
- Netwrix Change Tracker Gen 7 Agent (8.2 or later) installed on the same server. The Gen 7
Agent MSI installs Netwrix Activity Monitor (including the
SBTServiceWindows service) automatically as part of the agent installation. - A FIM policy with live tracking applied to the device from the Hub. See Policy Templates: FIM File Integrity for additional information.
How it works
When you enable the integration:
- The Gen 7 Agent automatically generates a configuration file (
SBTFileMon.ChangeTracker.ini) in the Activity Monitor configuration directory whenever it receives a FIM policy from the Hub. This file instructs Activity Monitor which paths to monitor and in what format to log events. - Activity Monitor's
SBTServicewrites file change events, including the user account and process name responsible, to a daily JSON log file on the local disk. The service names these files{hostname}_CT_Log_{YYYYMMDD}.json. - The Gen 7 Agent continuously reads these log files and caches attribution data keyed by file path.
- When the agent's file system watcher detects a file change, it attaches the cached attribution data to the event before sending it to the Hub.
The agent and the kernel driver are mutually exclusive as attribution sources. If you configure both, Activity Monitor takes precedence and the agent doesn't load the kernel driver.
Configuration
Configure Activity Monitor integration in the Gen 7 Agent's configuration file, located at:
C:\Program Files\NNT Change Tracker Suite\Gen7Agent (NetCore)\Gen7Agent.App.NetCore.dll.config
Add or update the following keys in the <appSettings> section:
| Key | Value | Description |
|---|---|---|
useActivityMonitorChangeSource | true | Enables Activity Monitor as the attribution source. Set to false (or omit) to use the default kernel driver. |
activityMonitorChangeSourceDirectory | Path to log directory | The folder where Activity Monitor writes its log files. The default is C:\ProgramData\Netwrix\Activity Monitor\Agent\ActivityLogs. Must match the LOG_FILE directory in the auto-generated INI file. |
changeSourceFileFormat | json (default) or tsv | Log file format that Activity Monitor writes. Leave as json unless you explicitly configure Activity Monitor for TSV output. |
loaddriver | true (default) or false | Controls whether the agent loads the kernel mini-filter driver (NNTInfo.sys) for file change attribution. Mutually exclusive with useActivityMonitorChangeSource. When both are true, Activity Monitor takes precedence and the agent doesn't load the driver. |
Example <appSettings> entries:
<add key="useActivityMonitorChangeSource" value="true" />
<add key="activityMonitorChangeSourceDirectory" value="C:\ProgramData\Netwrix\Activity Monitor\Agent\ActivityLogs" />
<add key="changeSourceFileFormat" value="json" />
The useActivityMonitorChangeSource and loaddriver settings are mutually exclusive as
attribution sources. If you set both to true, the agent automatically uses Activity Monitor
and disables the kernel driver. You don't need to explicitly set loaddriver=false, but you
can do so to make the configuration clearer.
Step 1 – Open Gen7Agent.App.NetCore.dll.config in a text editor with administrator
privileges and add the preceding keys with the appropriate values for your environment.
Step 2 – Restart the Gen 7 Agent service for the changes to take effect:
Restart-Service Gen7AgentCore
Step 3 – Confirm that the device has a FIM live-tracking policy assigned from the Hub. The agent generates the Activity Monitor INI file the next time it receives a device configuration update. To trigger this immediately, navigate to Settings > Agents and Devices, select the device, and click Refresh Configuration.
Auto-generated INI file
When the agent receives a FIM policy, it automatically writes
SBTFileMon.ChangeTracker.ini alongside the Activity Monitor's existing main configuration
file. The agent discovers the correct directory by reading the registry key:
HKLM\SYSTEM\CurrentControlSet\Services\SBTLogging\Parameters\ConfigPath
The INI file instructs Activity Monitor to log file events to the directory that
activityMonitorChangeSourceDirectory specifies, using the path filters that the Hub's FIM policy
defines. You don't need to manually edit this file, as the agent regenerates it each
time the FIM policy changes.
If you remove the FIM policy from a device, the agent automatically disables the corresponding section in the INI file.
The SBTFileMon.ChangeTracker.ini file is separate from Activity Monitor's main
SBTFileMon.ini. The agent doesn't modify other monitoring sections in SBTFileMon.ini.
Troubleshooting
No user attribution in events
- Confirm
SBTServiceis running:Get-Service SBTService. This service appears as Netwrix Windows File Monitoring Service inservices.msc. - Verify the
activityMonitorChangeSourceDirectorypath exists and contains files matching the pattern*_CT_Log_{YYYYMMDD}.json. - Check the agent's
rolling-log.txtfor warnings fromActivityMonitorChangeSource. Look for messages indicating the directory or log file can't be found.
INI file not generated
- Check that the registry key
HKLM\SYSTEM\CurrentControlSet\Services\SBTLogging\Parameters\ConfigPathexists and contains a valid path. The Activity Monitor installer creates this key; if it is missing, Activity Monitor may not be installed correctly. - Confirm that the Hub assigns the FIM policy to the device and that the policy template enables live tracking.
Both driver and Activity Monitor appear active
- If you set both
loaddriveranduseActivityMonitorChangeSourcetotruein the<appSettings>section ofGen7Agent.App.NetCore.dll.config(see Configuration), the agent automatically uses Activity Monitor and disables the kernel driver. You can optionally setloaddrivertofalseto make the configuration explicit.