This online help file is for EFT Server version 6.2.x. For other versions of EFT Server, please refer to http://help.globalscape.com/help/index.html. (If the Index and Contents are hidden, click Show Contents pane in the top left corner of this topic.) |
This topic applies to EFT Server version 6.1 and later. |
EFT Server can be instructed to log specific or all HTTP request headers. For this registry key to work, a file called logging.cfg it in the EFT Server installation folder (e.g., (C:\Documents and Settings\All Users\Application Data\GlobalSCAPE\EFT Server Enterprise\logging.cfg), must be configured to log at the DEBUG level. With this logging file, EFT Server logs requests that require authentication and those that cause session-checking failures. The information is logged to a file named EFT.log in the EFT Server installation folder (e.g., C:\Documents and Settings\All Users\Application Data\GlobalSCAPE\EFT Server Enterprise\). If you want to save EFT.log to a different location, change the reference in the logging.cfg file: log4cplus.appender.R.File=${AppDataPath}\EFT.log.
EFT.log organizes logging levels as a hierarchy: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF. When you specify a logging level, each of the lower levels is also included. That is, if you specify DEBUG level, you also get INFO, WARN, ERROR, and FATAL logs. However, if you specify INFO, you will not log DEBUG or TRACE level activities.
[HKEY_LOCAL_MACHINE\SOFTWARE\GlobalSCAPE Inc.\EFT Server 4.0\EFTClient]
"log_request"=dword:1
1 = enable "all request header" logging
0 = disable "all request header" logging [default]
Appenders determine where the output of the logging goes. Each logger can have more than one appender and inherits appenders from parents by default. Appenders have an associated layout that determines the content of the log lines. EFT Server uses a RollingFileAppender with the TTCCLayout. With this layout, the log contains the name of the logger, date/time, thread id, the log line itself, and other things.
Below are examples from a logging.cfg file:
log4cplus.rootLogger=WARN, R log4cplus.logger.HTTP=TRACE log4cplus.appender.R=log4cplus::RollingFileAppender log4cplus.appender.R.File=${AppDataPath}\EFT.log log4cplus.appender.R.MaxFileSize=20MB log4cplus.appender.R.MaxBackupIndex=5 log4cplus.appender.R.layout=log4cplus::TTCCLayout |
The file logging.cfg in the EFT Server installation folder provides details of how EFT Server uses Log4Cplus. For more information about Log4Cplus, refer to http://log4cplus.sourceforge.net/docs/html/classlog4cplus_1_1PropertyConfigurator.html#21e8e6b1440cc7a8a47b8fd14c54b239
All loggers inherit from the root logger; i.e., this is the default level that applies to all loggers:
log4cplus.rootLogger=INFO, R
To enable other loggers, use the following text:
#log4cplus.logger.Administration=TRACE
#log4cplus.logger.ARM=TRACE
#log4cplus.logger.HTTP=TRACE
#log4cplus.logger.AS2=TRACE
#log4cplus.logger.Reporting=TRACE
#log4cplus.logger.Server.Startup=TRACE
#log4cplus.logger.ServerStop=TRACE
#log4cplus.logger.CFG.Read=TRACE
#log4cplus.logger.CFG.Write=TRACE
#log4cplus.logger.AUD.Read=TRACE
#log4cplus.logger.AUD.Write=TRACE
#log4cplus.logger.AuthManager=TRACE
#log4cplus.logger.Events=TRACE
#log4cplus.logger.Events.Server=TRACE
#log4cplus.logger.Events.Site=TRACE
#log4cplus.logger.Events.Conn=TRACE
#log4cplus.logger.Events.Client=TRACE
#log4cplus.logger.Events.FS=TRACE
#log4cplus.logger.Events.AS2=TRACE
#log4cplus.logger.PGP.Adapter=TRACE
#log4cplus.logger.CmdAccess=TRACE
#log4cplus.logger.AWAccess=TRACE
#log4cplus.logger.SMTP=TRACE
#log4cplus.logger.AdminSupport=TRACE
#log4cplus.logger.FileSystem=TRACE
#log4cplus.logger.Reports=TRACE
#log4cplus.logger.FTP=TRACE
#log4cplus.logger.SSL=TRACE
#log4cplus.logger.SFTP=TRACE
#log4cplus.logger.Service=TRACE
#log4cplus.logger.Common=TRACE
#log4cplus.logger.Administrator=TRACE
#log4cplus.logger.DMZSupport=TRACE