Technical Tip: How to gather log bundles from the Reveal Agent

The logs from the Reveal Agent are gathered by generating a debug bundle.  Below are the steps to gather the bundle for the respective operating systems.

Notes: 

• For more verbose logging, add '-v' to the end of the command (for any OS).
• For a standard/advanced performance report add '-m performance_lite' or '-m performance' respectively to the end of the command (for any OS). Note that an advanced report may require additional time to complete (see below).
• To set the timeout (in seconds) for the bundle collection to complete add '-t 600' to the end of the command (for any OS), replacing 600 with the desired time (600 is the default). For full performance or verbose logs, it is recommended at least 1800 seconds.

Windows:

For a comprehensive set of logs, use the agent 'debug bundle' functionality which will generate a zipped log file bundle.

Method:

Open an administrator cmd.exe prompt:

Type:

"C:\Program Files\Jazz Networks\Agent\agent.exe" debug bundle

Depending on the agent version, it may take a few minutes for the bundle collection to complete. The bundle will be placed in the  current working directory.

To collect a verbose debug bundle, add the type:

"C:\Program Files\Jazz Networks\Agent\agent.exe" debug bundle -v

Note:

• This command requires the elevated command prompt to work correctly, contact the system administrator if there is no administrative permissions on the machine.

Mac OS:

To get comprehensive logs for troubleshooting the Mac Agent,  use the debug bundle command. (Requires elevated permissions).

Jazz Agent 7.1.4 (and earlier):

sudo /Applications/Jazz\ Networks.app/Contents/Resources/agent debug bundle

Reveal Agent 7.2.3 - 7.5.1 (inclusive):

sudo /Applications/Ava\ Reveal.app/Contents/Resources/agent debug bundle

Reveal Agent 7.6.1 (or later):

sudo /Library/Application\ Support/Ava/Reveal/agent/agent debug bundle

The compressed log output will be written to the current working directory.

Linux:

To get comprehensive logs for troubleshooting of the Linux Reveal Agent, use the debug bundle command. (Requires elevated permissions):

sudo jazz-agent debug bundle

This will be placed in the current working directory.