This article was updated to support v12.0.1 and newer of Goliath Performance Monitor.
With Goliath there are two type of logs, server logs and agent logs. The server logs are enabled by default and log all actions to disk that the Goliath Server is processing. The agent logs are not enabled by default and need to be turned on in order to log all actions to disk that the Goliath Agent is processing. The following articles reviews how to enable and gather the Goliath Server & Agent Logs.
Goliath Server Logs
Confirm Server Logging is Enabled
The below steps will walk you through how to confirm that server logging is enabled. If you know that logging is enabled already, please continue to the next section.
- Connect to the Goliath Server web console
- Click the ‘Settings’ link in the top right-hand corner of the technology
- Under the ‘Tools & Logs’ section, select the ‘Server Logs’ option
- Confirm that the checkbox in the bottom right corner labeled‘Log to Disk’ is checked. If it is not, please check it now. This will start the server logging from this point forward so if you are experiencing support related issues you may need to wait for the issue to occur again until logs can be collected & sent to the support team.
Gather the Server Logs
The below steps will walk you through how to gather the server logs.
- On the Goliath server, open Windows File Explorer and navigate to the ‘Bin’ directory within the Goliath install directory
- The default location is either “C:\Program Files (x86)\MonitorIT\Bin” or “C:\Program Files\MonitorIT\Bin” depending on your Goliath version
- if you changed the drive in which Goliath was installed, please replace “C” with the appropriate drive letter
- The default location is either “C:\Program Files (x86)\MonitorIT\Bin” or “C:\Program Files\MonitorIT\Bin” depending on your Goliath version
- Sort the folder by the date modified column to bring the most recent items to the top
- Retrieve the files labeled MonitorITServ*.log, GoliathServer.dmp, and GPMServer.log*
- Also, the most recent log file is named MonitorITServer.log while older logs are named MonitorITServer_MMDDYY_hhmmss.log. It is important to look at the date & times included in the log file name as the support engineer may ask for the latest 1-3 hours of logs.
- Please zip the file all of the files together and name the folder “OrganizationName-Ticket#”
- For example, “Walmart-1265”
- Upload the requested logs to link provided or directly to the support ticket.
Goliath Agent Logs
Enable & Gather Windows Agent Logs
The below steps will walk you through how to enable & gather agent logs.
- Open the Goliath web console
- Choose the“Configure” tab and select the “Inventory” sub-menu option
- If Logging is already enabled on the specific machine(s), please skip to step 5.
- To tell if agent logging is already enabled, in the ‘Log’ column look to see if there is a a green check mark for the machine(s) in question. If there is not, please proceed to the next step.
- To tell if agent logging is already enabled, in the ‘Log’ column look to see if there is a a green check mark for the machine(s) in question. If there is not, please proceed to the next step.
- If Logging is not already enabled, you will see a grey check box. To enable agent logging:
- Click the check box and a popup will appear
- Select the check box for “Agent Log to Disk”
- Select Close to finish the enablement
- Now that agent logging is enabled, please wait 30-60 minutes before continuing, or until the support event occurs again
- Please note, depending on the support ticket the support engineer may request that you restart the MonitorIT Agent Service on this machine before proceeding as well
- When ready to gather the logs, click on the check mark for the agent(s)you have been collecting data for
- Click the button for “Upload Agent Logs”
- Please note, this upload is from the agent location to the Goliath Server
- The logs will be located on the Goliath Server at “C:\Program Files (x86) \MonitorIT\AgentLogs” or “C:\Program Files\MonitorIT\AgentLogs”, depending on your Goliath version
- Inside that directory the logs are organized by machine name
- Please zip the file all of the files together and name the folder “OrganizationName-Ticket#”
- For example, “Walmart-1265”
- Upload the requested logs to link provided or directly to the support ticket.
If you need to manually enable the Agent Logs:
- Ensure the logging has been enabled via the UI (above)
- RDP to the machine where logging needs to be turned on
- Stop the MonitorIT Agent Service on the the machine where logging needs to be turned on
- Run regedit
- If running agent version 11.9.x or older:
- go to HKLM\Software\Wow6432Node\BreakoutTechnologies\MonitorIT\Agent
- If running agent version 12.x or newer:
- go to HKLM\Software\BreakoutTechnologies\MonitorIT\Agent
- If running agent version 11.9.x or older:
- Change the "DiskLogging" field to be "ON" , case sensitive
- Start the MonitorIT Agent Service
- Let logging run for the amount of time recommended by Goliath Support
- Proceed to next section to manually collect the agent logs
If you need to manually collect the Agent Log files:
- Agent Logs must be enabled before you will be able to collect them. (See steps above)
- On the machine that has the Goliath Agent installed, navigate to the ‘C:\Program Files\MonitorIT’ folder.
- The logs will have a filename that matches ‘MonitorITAgent*.log’
- Please zip the file all of the files together and name the folder “OrganizationName-Ticket#”
- For example, “Walmart-1265”
- Upload the requested logs to link provided or directly to the support ticket.
Enable Linux Agent Logs
The agent logging commands are to be performed by first stopping the agent and then restarting it with the additional commands for logging.
Stop the Agent
java -cp /opt/monitorit/MonitorITAgentStart.jar AgentStart -s GOLIATHIPAddress –shutdown
Start the agent with Logging:
Note: There are a couple of commands you can use to specify the behavior, all of which must appear before the "&”:
1. Start the agent using the following as a base:
nohup /FullyQualifiedPathToTheInstalledJava/bin/java -cp MonitorITAgentStart.jar AgentStart -s GOLIATHIPAddress -p 8282 &
2. Specify how the logging options:
- Choose where the log files will go
- "-l /folder/folder" which tells the agent where to put the log files. By default, this is "/var/log"
- Specify the logging level: "-logging" which turns on normal logging, or "-debug" which turns on more verbose logging.