How to access a Foglight Agent log file (4310324)

General details about an agent log file name

• The filename is in the following format: AGENTNAME_YYYY_MM_DD_HHMMSS_XXX.log and includes the date and time of the last time when the FglAM process (service) was restarted.
• The most recent file of each set (based on the filename) will end with the .log (log file) extension and have the higher incremented value in the last three characters of the main filename.  
• Previous files for the set will be compressed .gz format and they usually will be larger than the other files with the same filename timestamp

Accessing the file

The agent log file can be accessed from the UI, directly from the server, and from a Foglight Agent Manager (FglAM) support bundle.

Using the Foglight UI

users may need the Administrator role to access this panel

• Navigate to Administration | Agents | Agent Status
  
• Click the Log File icon to download a copy of the FMS log through the browser to the local desktop of the user's PC
  
• Open the text file in a text editor (e.g., Vim, Pico, Microsoft Wordpad)

Opening the file directly on the server

• From a command line (in Linux/Unix) or using Windows Explorer, navigate to {FglAM location}\state\default\logs\fb8be857-fbcf-4747-973d-295a8570e581\{CARTRIDGE_TYPE}\{VERSION}\{AGENT_TYPE}\
• Look for the most recent copy of the FMS log named AgentName_YYYY_MM_DD_HHMMSS_XXX.log
• Open the text file in a text editor (e.g., Vim, Pico, Microsoft Wordpad)

From a FglAM support bundle

• Generate a FglAM support bundle (as described in Knowledgebase article 41911
• Open the Support Bundle and drill down into state\default\logs\fb8be857-fbcf-4747-973d-295a8570e581\{CARTRIDGE_TYPE}\{VERSION}\{AGENT_TYPE}\
• Look for the most recent copy of the agent log named AGENTNAME_YYYY_MM_DD_HHMMSS_XXX.log
• Open the text file in a text editor (e.g., Vim, Pico, Microsoft Wordpad)

Reviewing the log file

• Note: Large log files such as the FglAM log and Agent Log may be much slower in Windows Notepad due to how Notepad manages files in memory.
• In the text editor, change the content of the wrap the lines (word wrap) for easier error log message reading.
  
• Scroll down to the bottom of the file to find the most recent error messages.
  
• Identify the error message that occurred. The subsequent stack error content can be ignored as it is used exclusively by developers to determine how various subroutines work together during execution of the code.
• Reference this error message in researching the Supportlink knowledgebase or when reaching out to Support for assistance.