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:
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.
Log Entry Severity Levels
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.