Post-Installation Configuration

Application Name Renaming for Collected URLs and Page Titles

The Web App Tracker Plugin collects URLs and page titles that are used to identify web applications in reports. You can rename the associated application names to better align with your organization's naming conventions or reporting requirements. For instructions, refer to Application Name Renaming for Collected URLs and Page Titles.

Optional Configurations

The Web App Tracker Plugin is ready to use after installation. You can configure the following settings to customize its behavior for your environment:

• Configuring Auto Download Interval
• Configuring Idle Detection Threshold
• Enabling or Disabling Plugin Debugging

Configuring Auto Download Interval

Use this procedure to configure how often the Web App Tracker Plugin automatically downloads data.

Step 1: Open the Configuration File

1. Navigate to the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration.

2. Open the browser_plugin_settings.json configuration file.

Step 2: Update the Auto Download Interval

1. Locate the downloadIntervalMinutes setting.

   browser_plugin_settings.json

   {
       "idleDetectionEnabled": true,
       "idleTimeoutMinutes": 5,
       "showIdlePopup": true,
       "enableAutoDownload": true,
       "downloadIntervalMinutes": 60,
       "debuglog": true
   }

   warning

   The auto download interval must not exceed 60 minutes.

2. Set the desired auto download interval.

   browser_plugin_settings.json

   {
       "idleDetectionEnabled": true,
       "idleTimeoutMinutes": 5,
       "showIdlePopup": true,
       "enableAutoDownload": true,
       "downloadIntervalMinutes": 30,
       "debuglog": true
   }

Step 3: Save the Changes

1. Save the configuration file. The new auto download interval is applied automatically.

Step 4: Distribute the Updated Configuration

1. Distribute the updated configuration file to the clients by following the steps outlined in the Manually Creating and Downloading a Distributable Configuration Files Package section.

Configuring Idle Detection Threshold

By default, the Web App Tracker Plugin considers a user idle after 5 minutes of inactivity. Use this procedure to configure the idle detection threshold to meet your organization's requirements.

Step 1: Open the Configuration File

1. Navigate to the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration.

2. Open the browser_plugin_settings.json configuration file.

Step 2: Update the Idle Threshold

1. Locate the idleTimeout setting.

   browser_plugin_settings.json

   {
       "idleDetectionEnabled": true,
       "idleTimeoutMinutes": 5,
       "showIdlePopup": true,
       "enableAutoDownload": true,
       "downloadIntervalMinutes": 60,
       "debuglog": true
   }

   note

   The maximum supported idle detection threshold is 60 minutes.

2. Set the desired idle threshold.

   browser_plugin_settings.json

   {
       "idleDetectionEnabled": true,
       "idleTimeoutMinutes": 10,
       "showIdlePopup": true,
       "enableAutoDownload": true,
       "downloadIntervalMinutes": 60,
       "debuglog": true
   }

Step 3: Save the Changes

1. Save the configuration file. The new idle threshold is applied automatically.

Step 4: Distribute the Updated Configuration

1. Distribute the updated configuration file to the clients by following the steps outlined in the Manually Creating and Downloading a Distributable Configuration Files Package section.

Enabling or Disabling Plugin Debugging

By default, plugin debugging is enabled. Use this procedure to enable or disable debugging for the Web App Tracker Plugin.

Step 1: Open the Configuration File

1. Navigate to the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration.

2. Open the browser_plugin_settings.json configuration file.

Step 2: Update the Debug Logging

1. Locate the debuglog setting.

   browser_plugin_settings.json

   {
       "idleDetectionEnabled": true,
       "idleTimeoutMinutes": 5,
       "showIdlePopup": true,
       "enableAutoDownload": true,
       "downloadIntervalMinutes": 60,
       "debuglog": true
   }

2. Set the desired value.

   browser_plugin_settings.json

   {
       "idleDetectionEnabled": true,
       "idleTimeoutMinutes": 10,
       "showIdlePopup": true,
       "enableAutoDownload": true,
       "downloadIntervalMinutes": 60,
       "debuglog": false
   }

Step 3: Save the Changes

1. Save the configuration file. The debug logging configuration is applied automatically.

Step 4: Distribute the Updated Configuration

1. Distribute the updated configuration file to the clients by following the steps outlined in the Manually Creating and Downloading a Distributable Configuration Files Package section.

Log File Details

The log files are saved in the Log directory, which is by default in C:\Program Files\OpeniT\Core\Log. Each generated log file also includes the last 50 log entries from the previous log file to preserve context for troubleshooting.

Diagnostic log files use the following naming convention:

Web App Tracker Plugin Log File Name

Web App Tracker Plugin-<browser>_<epoch>.log

where:

• <browser> is the browser in which the plugin is running (for example, chrome or edge).
• <epoch> is the epoch timestamp representing when the log file was created.

Log File Example

Webapptrackerplugin-edge_1784528334226.log