Difference between revisions of "OX6:Setting Loglevels"

Line 1: Line 1:
Usually our groupware and admin daemon tend to be pretty shy, and don't provide much log output. With some charm and the correct configuration parameters they can be coaxed into being more talkative. Have a look at the files:
+
= Open-Xchange loglevels =
  
* /opt/open-xchange/etc/groupware/file-logging.properties
+
The loglevel Open-Xchange backend is using for each single class can be defined in the file <tt>/opt/open-xchange/etc/file-logging.properties</tt>.
* /opt/open-xchange/etc/admindaemon/file-logging.properties
 
  
These are for the groupware and admin daemon respectively. If you want to turn both into babbling processes change the line:
+
To increase the loglevel of the complete Open-Xchange software stack, set
  
 
<pre>
 
<pre>
.level = SEVERE
+
.level = ALL
 
</pre>
 
</pre>
  
to
+
on top of that file.
 +
 
 +
As also explained on top of the same file, the following loglevels exist:
 +
 
 +
* ALL
 +
* INFO
 +
* FINE
 +
 
 +
When you changed any value, a restart of the Open-Xchange server is required.
 +
 
 +
== Change loglevel without restarting Open-Xchange ==
 +
 
 +
It is also possible to change the loglevel while Open-Xchange is running. This can be achieved by the tool <tt>showruntimestats</tt>.
 +
 
 +
Given the same example as above, changing loglevel to ALL of the complete Open-Xchange stack, run
 +
 
 +
$ /opt/open-xchange/sbin/showruntimestats -d 'java.util.logging:type=Logging!setLoggerLevel!!ALL!'
 +
 
 +
and to revert back either restart Open-Xchange or run
  
<pre>
+
$ /opt/open-xchange/sbin/showruntimestats -d 'java.util.logging:type=Logging!setLoggerLevel!!INFO!'
.level = ALL
 
</pre>
 
  
and restart the process in question. This might help you get closer to whatever problem buggers you.
+
'''Note:''' Changing loglevel via this tool does not change it permanently. After a restart, the values from the file <tt>/opt/open-xchange/etc/file-logging.properties</tt>
 +
are used again.

Revision as of 08:17, 30 August 2013

Open-Xchange loglevels

The loglevel Open-Xchange backend is using for each single class can be defined in the file /opt/open-xchange/etc/file-logging.properties.

To increase the loglevel of the complete Open-Xchange software stack, set

.level = ALL

on top of that file.

As also explained on top of the same file, the following loglevels exist:

  • ALL
  • INFO
  • FINE

When you changed any value, a restart of the Open-Xchange server is required.

Change loglevel without restarting Open-Xchange

It is also possible to change the loglevel while Open-Xchange is running. This can be achieved by the tool showruntimestats.

Given the same example as above, changing loglevel to ALL of the complete Open-Xchange stack, run

$ /opt/open-xchange/sbin/showruntimestats -d 'java.util.logging:type=Logging!setLoggerLevel!!ALL!'

and to revert back either restart Open-Xchange or run

$ /opt/open-xchange/sbin/showruntimestats -d 'java.util.logging:type=Logging!setLoggerLevel!!INFO!'

Note: Changing loglevel via this tool does not change it permanently. After a restart, the values from the file /opt/open-xchange/etc/file-logging.properties are used again.