Log Files

The application log file includes detailed transfer information and can be useful for
review and support requests. You can redirect Aspera logging so that it is not recorded
in the system log file and configure log rotation.

Viewing Logs and Setting Log Preferences

To view the log, click
Tools > View Log.

To set the logging level for transfers, open the My
Preferences dialog by clicking Tools >
Preferences or by clicking Preferences in the
upper-right corner of the application window.

The five logging levels to select from are:
Off, Error,
Warn, Info, and
Debug. The system default is Info.

Redirecting Aspera Logging to a Different Location

On Linux systems, the application transfer logs are recorded in the system log file.
Instead of mixing Aspera logging with system logging, you may want to redirect
Aspera logging to a separate log file of your choice.

RedHat, CentOS, and Debian

On RedHat, CentOS, and Debian, the transfer logs are recorded in the following log
file: /var/log/messages

To redirect Aspera logging, modify /etc/syslog.conf
(/etc/rsyslog.conf in the case of Red Hat or CentOS 6.XA)
and add local2.none to the /var/log/messages
line. For example, if you have the following line:

Next, forward local2.info log messages to your new file. For
example, to write to /var/log/aspera.log, add the following
line just below the line you modified above:

local2.info -/var/log/aspera.log

The log file name should be separated from the log facility
(local2.info) by tab characters, not spaces and be preceded
by a hyphen. The hyphen before the log file name allows for asynchronous logging.

Next, restart the syslog daemon to have it load the new configuration:

The first option will rotate your logs with the system logs (usually once a week,
compressed, and saving the last 10 logs). On some servers, there is so much traffic
that the logs need to be rotated more often than once a week, in which case option 2
or 3 should be used.

1. Add /var/log/aspera.log to the entries in
/etc/logrotate.d/syslog, as follows:

2. Edit /etc/logrotate.conf by adding the configuration after
the line "# system-specific logs may also be configured here." The
following example compresses and rotates 10 logs whenever
/var/log/aspera.log reaches 100MB. After log rotation is
complete, it will run whatever scripts are specified by postrotate ...
endscript.

The following example below compresses and rotates 10 logs once daily. Instead of
moving the original log file and creating a new one, the
copytruncate option tells logrotate to
first copy the original log file, then truncate it to zero bytes.