Starting with the version 2.2.x of our Linux Server Monitoring Agent, we’ve introduced Debug Mode.

This mode, when turned on, allows your agent to generate a log file, located at /etc/hetrixtools/debug.log which you can send it to our support staff in order to debug potential issues with your agent.

Turn on Debug Mode

sed -i 's/DEBUG=0/DEBUG=1/' /etc/hetrixtools/hetrixtools.cfg

Turn off Debug Mode

sed -i 's/DEBUG=1/DEBUG=0/' /etc/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.