Log Files

Log files contain information on the activities that are performed in JMap Server. The quantity of events written in the log files depends on the selected logging level. By default, a new log file is created every day but this parameter can be adjusted. By default, log files are located in the directory JMAP_HOME/logs. You may need to periodically check the volume of the log files and archive or delete old ones.

Log level	The maximum level of the messages added to the log files. For example, if Warning is selected, only messages with a level of Warning, Error or Fatal will be written in the log files. The following log levels are available (listed in descending order): All: Every event is written. Use only to solve a problem. Debug: Debug level events are written. Use only to solve a problem. All lower level events are also written. Info: Information level events are written. This includes user logins. All lower level events are also written. Warning: Warning (non serious) level events are written. All lower level events are also written. Error: Error (serious) level events are written. All lower level events are also written. Fatal: Only fatal error (very serious) events are written. Off: Nothing is written.
Log file directory	Directory where to create the log files. Default is under JMAP_HOME/logs. Make sure there is sufficient disk space to hold log files.
File age limit	The file age limit determines how often new log files are created. The current log file is always called jmap_log. When a new file is created, the current log is renamed to include the date (e.g. jmap_log_2006_05_23.log).
Messages to console	Determines if events will also be written in JMap Server screen console. This is useful for tests or development but should be turned off during production. Moreover, when JMap Server has no output console (started as a background process or as a service on Windows), this option is useless and consumes server resources for nothing.

Viewing log files

Log files (and error files) can be viewed directly in JMap Admin. Select the name of a file from the list to open it. The content of the file is displayed. Note that error files are also listed along with log files. The error files contain only error messages that can sometimes complement the log files to help solve a problem.

The view window allows you to filter the content by event type, date, keyword, etc. You can also download the file by clicking on Download.

Analyzing log files

Log files can be analyzed in order to provide a summary of the activity of JMap Server. For instance, they can inform you of the number of sessions for each user, the number of server shutdowns, authentication failures, etc. To analyze log files, select one or more files in the list and click on Analyze.