Debug Mode – Windows Agent

Starting with the version 2.0.4 of our Windows Server Monitoring Agent, we’ve introduced Debug Mode.

This mode, when turned on, allows your agent to generate a log file located at 
C:\Program Files\HetrixTools\debug.log, which you can send to our support staff in order to debug potential issues with your agent.

To turn Debug Mode on/off, run the following commands in your Windows PowerShell terminal as administrator (when opening the PowerShell terminal, right-click it and select “Run as administrator”).

Turn on Debug Mode

(Get-Content "C:\Program Files\HetrixTools\hetrixtools.cfg") -replace "DEBUG=0", "DEBUG=1" | Set-Content "C:\Program Files\HetrixTools\hetrixtools.cfg"

Turn off Debug Mode

(Get-Content "C:\Program Files\HetrixTools\hetrixtools.cfg") -replace "DEBUG=1", "DEBUG=0" | Set-Content "C:\Program Files\HetrixTools\hetrixtools.cfg"

We recommend turning on Debug Mode only when instructed by our support team and not letting it run indefinitely.

The debug.log file is automatically cleared by the agent at midnight every day.

For frequently recurring issues (i.e., if your agent is not sending data at all or has frequent interruption gaps):

  • Enable debug Mode and let it run for about 10-20 minutes, enough to capture a few events, before sending the debug.log file to our support team.
  • The debug.log file will only be a few MB in size.

For infrequently recurring issues (i.e., if your agent is only sometimes not sending data):

  • Enable debug Mode and let it run for a few hours to try to capture an event before sending the debug.log file to our support team.
  • Keep in mind that the debug.log file is cleared at midnight every day.
  • The debug.log file can reach a few hundred MB in size; make sure your server has enough storage space for it.
  • Please archive the debug.log file before sending it to our support team.
Tagged: