Confluence Docs 3.0 : Working with Confluence Logs This page last changed on Sep 25, 2009 by jlargman. On this page: Logs Location Background Finding the Log Configuration File Changing the Destination of the Log Files Changing the Logging Levels Using Some Specific Confluence Logging Options ## Logs Location This section describes Confluence's default logging behaviour, assuming that you have not changed the destination of the logs. So as to unify logging across different application servers, Confluence uses the atlassian-confluence.log, not the application server log, as it's primary log.
| Atlassian Support will almost always ask for the atlassian-confluence.log from the `confluence-home/logs` directory. The easiest way to find this location is to look for the "Confluence Home" setting from `Administration > System Information`. If you can't access `Administration > System Information`, check `<confluence-install>/confluence/WEB-INF/classes/confluence-init.properties` and look for the confluence.home setting, then find the logs in that directory.
For Confluence 2.6.x and earlier, the default behaviour is: For Confluence Standalone, log entries are written to `<confluence_install>/logs`. The main log file is called `atlassian-confluence.log`. For Confluence EAR/WAR, log entries are written to the application server logs, i.e. the default log files of the application container. For Confluence 2.7.x and later, both Standalone and EAR/WAR distributions follow the same default behaviour: When you start Confluence, log entries will be sent to the application server logs until Confluence has completed its initial bootstrap. Any log entries written to the console will be repeated into the `<confluence-home>` log described below. Once the initial startup sequence is complete, all logging will be to `<confluence-home>/logs/atlassian-confluence.log`. For example: `c:/confluence/data/logs/atlassian-confluence.log`. Note that the default location is now the Confluence home directory instead of the application server's log file. The home directory is specified in <confluence-install>/confluence/WEB-INF/classes/confluence-init.properties. ## Background Confluence uses Apache's log4j logging service. This allows a developer or administrator to control the logging behavior and the log output file by editing a configuration file, without touching the application binary. There are six known log4j logging levels. ## Finding the Log Configuration File Confluence's logging behaviour is defined in the following properties file: `<CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties` This file is a standard log4j configuration file, as described in the Apache log4j documentation. ## Changing the Destination of the Log Files Terminology: In log4j, an output destination is called an 'appender'. To change the destination of the log files, you need to stop Confluence and then change the settings in the 'Logging Location and Appender' section of the `log4j.properties` file. The location of this file is described above. In the standard properties file supplied with Confluence 2.7 and later, you will find entries for two appenders: `com.atlassian.confluence.logging.ConfluenceHomeLogAppender` – This is a custom appender which controls the default logging destination described above. This appender allows the following settings: MaxFileSize MaxBackupIndex `org.apache.log4j.RollingFileAppender` – If you want to log to a different location, uncomment the `RollingFileAppender` line and change the destination file in the line below it. Comment out the previous lines referring to the `ConfluenceHomeLogAppender`. Confluence ships with the full suite of appenders offered by log4j. Read more about appenders in the log4j documentation. ## Changing the Logging Levels See Configuring Logging for instructions on how to change the logging configuration of Confluence. ## Using Some Specific Confluence Logging Options This section contains some pointers to specific log configurations you may need. #### Log the Details of SQL Requests made to the Database You may want to increase Confluence's logging so that it records individual SQL requests sent to the database. This is useful for troubleshooting specific problems. You can enable detailed SQL logging in two ways: At runtime – see instructions above. Via the logging properties file – see the detailed instructions. #### Log the Details of Users Viewing/Accessing each Confluence Page You can configure the log to show which users are accessing which pages in Confluence. This can only be done via the logging properties file – see the detailed instructions. #### Where are my Thread Dumps? Thread dumps are logged to the application server log file. ##### RELATED TOPICS Important Directories and Files Enabling detailed SQL logging Enabling user access logging Generating a Thread Dump Enabling Page Request Profiling Attachments: LogLevels.png (image/png)

Document generated by Confluence on Nov 05, 2009 23:27