Logging and Alerts

<< Click to Display Table of Contents >>

Navigation:  Peer Global File Service Help > Basic Concepts >

Logging and Alerts

Overview

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 Peer Management Center and Agent installation directories:

PMC Log Files

Agent Log Files

Basic-Concepts-Logging and Alerts-PMC Logs

Basic-Concepts-Logging and Alerts-Agent Logs

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 Peer Management Center 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 Peer Management Center.

2.From the Help menu, choose Retrieve PMC/Agent Logs.

The Retrieve PMC/Agent Log Files dialog is displayed.

Basic-Concepts-Logging and Alerts-Retrieve PMC-Agent Logs

3.Select the logging options.

There are three sets of options:

Log Collection Options

Agent Log Options

Encryption and Support Options

4.Enter the your contact information and a description of the problem:

Basic-Concepts-Logging and Alerts-Retrieve PMC-Agent Logs-Contact Info

This information will be sent to Peer Software Technical Support.

5.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.

Basic-Concepts-Logging and Alerts-Retrieve PMC-Agent Logs-Log Gathering Completed

6.Click OK.

The retrieved log file is stored as a zip file in the workspace/support subfolder in the Peer Management Center 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 and telemetry to Peer Software Support

Select this option if you want to automatically upload the zip file containing the log files and telemetry information to Peer Software Support.  No file data will be uploaded.