Overview of Logging
PeerGFS performs an extensive amount of logging to track events and activities processed by PeerGFS. The results are stored in log files that are useful for troubleshooting and analytics. PeerGFS tracks and logs many types of information and activities, including file events, preferences, job-specific configuration files, and analytics files. See File Event Logs and Alerts for more information about job-related file event logging.
Accessing Log Files
Many of the log files have an .log extension; these are text files that can be opened in a text editing application. Other log files are stored in other file formats such as .xml, .csv, and .prefs. Log files are stored in the workspace folder in the PMC and Agent installation directories:
PMC Log Files |
Agent Log Files |
|
|
If you want to review these files for troubleshooting or analytical purposes, you can retrieve them as a single, compressed file, which is then stored in the support folder in the PMC installation directory. The retrieval process compiles the various log files into a single zip file that is easy to review and send to others for review. When retrieving log files, you have various options, such as choosing which log files are included, whether to encrypt log files (which may contain sensitive information), and whether to have the zip file automatically sent to Peer Software Support.
Retrieving Log Files
To retrieve log files:
1.Open the PMC.
2.From the Help menu, choose Retrieve PMC/Agent Logs.
The Retrieve PMC/Agent Log Files dialog is displayed.
3.Select the logging options.
There are three sets of options:
•Encryption and Support Options
4.Click Yes to start the log retrieval process.
It may take some time for the log files to be collected and compiled into a single, compressed file. When the retrieval is finished, a message is displayed. The retrieved log file is stored as a zip file in the support subfolder in the PMC installation directory.
Log Collection Options
Include logs newer than X days |
Use this option to restrict the logs retrieved to a certain time period. |
Run Event Detection Analytics before log file collection |
Select this option to run event detections analytics immediately before the log files collected. PeerGFS can perform event detection analysis every night; however, this option allows you to receive the most up-to-date analytics. |
Collect only statistics files |
Select this option to retrieve log files that contain statistics only. |
Agent Log Options
Do not include any agent log files |
Select this option if you do not want to retrieve log files for any agent. |
Include all connected agent log files |
Select this option if you want to retrieve log files for all connected agents. |
Include the log files from the connected agents selected below |
Select this option if you want to retrieve log files for selected connected agents. |
Encryption and Support Options
Encrypt log files |
Select this option if you want to encrypt the log files in the zip file. |
Automatically upload log files to Peer Software Support |
Select this option if you want to automatically upload the zip file containing the log files to Peer Software Support. |