Transfer monitoring

Preface

PowerFolder is able to log all up- and download activities into either a flat file (CSV) or the internal H2 or any external database for monitoring purposes.

Requires: PowerFolder Server 3.0.0 or higher.

Installation

The monitoring feature can be enabled under Preferences/Log up- and downloads. It is also possible to do this inside of the configuration file by adding one or both of the following:

Enable CSV mode:

plugin.pro.monitor.transfer.use_csv=true

Enable database mode:

plugin.pro.monitor.transfer.use_sql=true

Of course it is possible to use both monitoring modes in parallel.

CSV

When the CSV mode is enabled, PowerFolder automatically creates a folder where all logfiles are placed and sends the data automatically to the current server. Up- and downloads logs are stored in separate UTF-8 encoded files in subdirectories based on current date. (Format: year/month/day/filename)

Examples: 2011/04/29/Downloads.csv, 2011/04/29/Uploads.csv.

Database

The database mode just writes the data into the configured database. Table 'TransferLogEntry'

Log format

Independent of the chosen mode following data will be logged:

datetime

The date and time the transfer was completed/stopped.

Example: "07.04.09 02:36"

startdatetime

The date and time the transfer was started.

Example: "07.04.09 02:31"

status

The result status of the transfers.

Possible values: "success" (completed gracefully)

"broken" (stopped because of problem)

"abort" (intentionally stopped).

type

The type of transfer.

Possible values: "dl" (download) or "ul" (upload)

newupd

Flag if file was updated or new.

Possible values: "new" (new file) or "upd" (update)

sender

The sender of the file.

Example: "Source-Desktop"

receiver

The receiver of the file.

Example: "Server"

folder

The folder the transfer was made on.

Example: "Backup-Data"

filename

The filename of the transferred file.

Example: "Sheet1.xls"

file

The full path information of the transferred file.

Example: "C: \Documents and Settings\user\PowerFolders\Project YZX\Sheet1.xls"

size

The total size in bytes of the file.

Example: 2002304

failreason

The reason why the transfer was not successfully completed.

Example: "NODE_DISCONNECTED".

Example file

This example files shows the transfer log output.