File Event Logs and Alerts

<< Click to Display Table of Contents >>

Navigation:  Peer Global File Service Help > Basic Concepts > Logging and Alerts >

File Event Logs and Alerts

File Event Logging

PeerGFS records various types of file events for file collaboration, file replication, file synchronization, and file locking jobs.  The events are written to to the fc_event.log file located in the Hub\logs subdirectory within the Peer Management Center installation directory.  All log files are stored in a tab-delimited format that can easily be read by Microsoft Excel or other database applications.  The events are also displayed in the Event Log tab located within the runtime summary view for the selected job.

Logging Fields

Below is a list of logging fields and their descriptions:

Field

Description

Enabled

Selecting this option will enable file event logging based on the other settings.  Deselecting this option will completely disable all logging.

Severity

Determines what severity levels will be logged. There are two options:

All (Informational, Warnings, Error, Fatal)

Errors & Warnings (Warnings, Error, Fatal)

Event Types

If checked, the corresponding event type will be logged.

File Open

A file was opened by a remote application on a source host.

File Lock

A file lock was acquired on a target host when a file open is detected on another host.

File Close

A file was closed.

File Add

A file was added to the watch set.

File Modify

A file was modified in the watch set.

File Delete

A file was deleted.

File Rename

A file was renamed.

Attribute Change

A file attribute was changed.

Security (ACL) Change

The security descriptor of a file or folder was changed.

Directory Scan

Indicates when a directory was scanned as a result of the initial synchronization process.

File ADS Transfer

The Alternate Data Stream of a modified file was synced to target host(s).

Configuring Job Logging and Alerts

You can configure the logging and alert settings for a job when you edit a job. By default, all file collaboration and synchronization activity is logged for all severity levels.  You can enable or disable file event logging, as well as select the level of granularity.

Basic-Concepts-Logging and Alerts-Configuring Logging

Log Entry Severity Levels

Level

Description

Informational

Informational log entry, e.g., a file was opened.

Warning

Some sort of warning occurred that did not produce an error but was unexpected or may need further investigation.

Error

An error occurred performing some type of file activity.

Fatal

A fatal error occurred that caused a host to be taken out of the session, a file to be quarantined, or a session to become invalid.

Job Alerts

Various types of alerts will be logged to a log file and to the Alerts table located within the job's runtime summary view for the selected job.  Each job will log to the fc_alert.log file located in the Hub\logs subdirectory within the Peer Management Center installation directory.

The default log level is WARNING, which will show any warning or error alerts that occur during a running session.  Depending on the severity of the alert, the job may need to be restarted.