Differences between revisions 9 and 12 (spanning 3 versions)
⇤ ← Revision 9 as of 2008-07-09 12:15:42 →
Size: 5747
Editor: gw
Comment:
← Revision 12 as of 2008-07-18 13:57:10 → ⇥
Size: 6125
Editor: gw
Comment:
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
By default [[SVNKit]] operations logging is switched off. To enable it, you should replace the contents of the {{{JAVA_HOME/jre/lib/logging.properties}}} file with the contents of the {{{logging.properties.disabled}}} file that you can find in your "standalone" archive or in the {{{svnkit/cli/}}} directory in case you've checked out the [[SVNKit]] sources. Or when launching the Java VM you can use the following system property: By default [[SVNKit]] operations logging is switched off. To enable it, you should replace the contents of the {{{JAVA_HOME/jre/lib/logging.properties}}} file with the contents of the {{{logging.properties.disabled}}} file that you can find in your "standalone" archive or in the {{{svnkit-cli/scripts}}} directory in case you've checked out the [[SVNKit]] sources. Or when launching the Java VM you can use the following system property:
Line 11: Line 11:
The {{{logging.properties.disabled}}} file contains a system property called {{{svnkit.level}}} which is used to control the log level. Up to your needs you can specify the following values for that property: The {{{logging.properties.disabled}}} file contains several system properties which is used to control the log level. Every property corresponds to different area of [[SVNKit]] operations:

 * svnkit.level - sets the log level of basic operations
 * svnkit-network.level - sets the log level for network operations, it enables or disables network tracing
 * svnkit-wc.level - sets the log level for operations with working copy
 * svnkit-cli.level - set the log level for operations performed by command line interface layer

Up to your needs you can specify the following values for every property above:
Line 31: Line 38:
'''Note:''' if this option is turned on error messages will be shown in the 'Error Log' output independently of whether {{{org.tmatesoft.svnkit/debug}}} is turned on or not Note: if this option is turned on error messages will be shown in the 'Error Log' output independently of whether {{{org.tmatesoft.svnkit/debug}}} is turned on or not
Line 36: Line 43:
'''Note:''' if this option is turned on network traffic will be shown in the 'Error Log' output even if {{{org.tmatesoft.svnkit/debug}}} is turned off Note: if this option is turned on network traffic will be shown in the 'Error Log' output independently of whether {{{org.tmatesoft.svnkit/debug}}} is turned on or not
Line 43: Line 50:
import org.tmatesoft.svn.util.ISVNDebugLog;
Line 45: Line 53:
import org.tmatesoft.svn.util.SVNLogType;
Line 48: Line 57:
     * Set up your logger      * Register your logger for different kinds of operations (operations with working copy, network operations).
Line 51: Line 60:
        SVNDebugLog.setLogger(new CustomSVNKitLogger());         ISVNDebugLog customLogger = new CustomSVNKitLogger();
        SVNDebugLog.setDefaultLog(customLogger);
        SVNDebugLog.registerLog(SVNLogType.WC, customLogger);
        SVNDebugLog.registerLog(SVNLogType.NETWORK, customLogger);
Line 56: Line 68:
     /* Override superclass methods to redirect logging
      * as you wish. Superclass implementaion is empty, i.e.
      * all log messages are swallowed.		      /* Define methods to handle log messages
      * as you wish.
Line 60: Line 71:
                      public void log(String message, byte[] data) {
             /*
              * Used to log all data received or transmitted
              * over network
              */
  ...
         }
                   public void logInfo(String message) {
             /*
              * Used to log information messages
              */
             ...
         }		         public void log(String message, byte[] data) {
            /*
             * Used to log all data received or transmitted
             * over network
             */
            ...
        }
Line 77: Line 79:
  public void logError(String message) {
  /*
              * Used to log error messages
  */
             ... 
         }		         public void log(String message, Level logLevel) {
            /*
             * Used to log messages with different log levels
             */
            ...
        }
Line 84: Line 86:
  public void logInfo(Throwable th) {
             /*
              * Used to log information on exceptions
              */
             ...
         }

         public void logError(Throwable th) {
             /*
  * Used to log exceptions
  */
             ...
         }		         public void log(Throwable th, Level logLevel) {
            /*
             * Used to log exceptions with different log levels
             */
            ...
        }

Logging SVNKit operations

If you experience problems that you think are related to SVNKit, it is always a good idea to post a bug report into SVNKit Issue Tracker. To provide more information with the bug report, please consider attaching SVNKit log file to it. Below you will find detailed instructions on how to get SVNKit log files.

SVNKit is used as a library in a standalone application

By default SVNKit operations logging is switched off. To enable it, you should replace the contents of the JAVA_HOME/jre/lib/logging.properties file with the contents of the logging.properties.disabled file that you can find in your "standalone" archive or in the svnkit-cli/scripts directory in case you've checked out the SVNKit sources. Or when launching the Java VM you can use the following system property: 

$java -Djava.util.logging.config.file=path/to/logging.properties.disabled

The logging.properties.disabled file contains several system properties which is used to control the log level. Every property corresponds to different area of SVNKit operations:

  • svnkit.level - sets the log level of basic operations
  • svnkit-network.level - sets the log level for network operations, it enables or disables network tracing
  • svnkit-wc.level - sets the log level for operations with working copy
  • svnkit-cli.level - set the log level for operations performed by command line interface layer

Up to your needs you can specify the following values for every property above:

  • FINE(default) - the level for not detailed logging
  • FINER - the level for more detailed logging
  • FINEST - the level for full logging

You may find an SVNKit log file at USER_HOME/svnkit.0.log.

SVNKit is used as Eclipse plugin (works for Subclipse extension as well)

When used within Eclipse SVNKit logs its operation using Eclipse built-in logging facilities. Logging is turned off by default. To enable SVNKit logging please do the following:

  1. Copy ECLIPSE_HOME/plugins/org.tmatesoft.svnkit_version/.options file to ECLIPSE_HOME directory

  2. Start Eclipse with -debug command line argument: 

$eclipse -debug

  1. In Eclipse, open standard 'Error Log' view - it will contain detailed log of SVNKit operations that you may export to a file.

ECLIPSE_HOME/plugins/org.tmatesoft.svnkit_version/.options is a file in Java properties file format, with key=true or key=false pair per line. It contains following options with boolean values you can specify:

  • org.tmatesoft.svnkit/debug - enables or disables SVNKit logging

  • org.tmatesoft.svnkit/debug/error - enables or disables printing error messages to the 'Error Log' output

Note: if this option is turned on error messages will be shown in the 'Error Log' output independently of whether org.tmatesoft.svnkit/debug is turned on or not

  • org.tmatesoft.svnkit/debug/warning - enables or disables printing warnings to the 'Error Log' output

  • org.tmatesoft.svnkit/debug/info - enables or disables printing debug information to the 'Error Log' output

  • org.tmatesoft.svnkit/debug/fine - enables or disables printing all messages to the 'Error Log' output

  • org.tmatesoft.svnkit/debug/trace - enables or disables tracing of network operations

Note: if this option is turned on network traffic will be shown in the 'Error Log' output independently of whether org.tmatesoft.svnkit/debug is turned on or not

Setting a custom logger (for debug logging)

When you're using SVNKit in your application it is not always an option to let SVNKit use JDK logging API. Instead you may like to have a fine-grained control over the way SVNKit logs its operations. The solution is to provide SVNKit with a custom logger class that should extend the SVNDebugLogAdapter class. The code below demonstrates how it could be done. 

   1 ...
   2 import org.tmatesoft.svn.util.ISVNDebugLog;
   3 import org.tmatesoft.svn.util.SVNDebugLog;
   4 import org.tmatesoft.svn.util.SVNDebugLogAdapter;
   5 import org.tmatesoft.svn.util.SVNLogType;
   6 ...
   7     
   8     /*
   9      * Register your logger for different kinds of operations (operations with working copy, network operations). 
  10      */
  11     public static void initSVNKitLogger() {
  12         ISVNDebugLog customLogger = new CustomSVNKitLogger();
  13         SVNDebugLog.setDefaultLog(customLogger);
  14         SVNDebugLog.registerLog(SVNLogType.WC, customLogger);
  15         SVNDebugLog.registerLog(SVNLogType.NETWORK, customLogger);
  16     }
  17 
  18     private static class CustomSVNKitLogger 
  19                                    extends SVNDebugLoggerAdapter {
  20         /* Define methods to handle log messages
  21          * as you wish.
  22          */
  23         public void log(String message, byte[] data) {
  24             /*
  25              * Used to log all data received or transmitted 
  26              * over network
  27              */
  28             ...
  29         }
  30 
  31         public void log(String message, Level logLevel) {
  32             /*
  33              * Used to log messages with different log levels
  34              */
  35             ...
  36         }
  37 
  38         public void log(Throwable th, Level logLevel) {
  39             /*
  40              * Used to log exceptions with different log levels
  41              */
  42             ...
  43         }
  44     }
  45 ...
  46     initSVNKitLogger();
  47 ...

Note: One have to set up a custom logger before any other calls are made to SVNKit, otherwise default logging will be used - i.e. DefaultSVNDebugLogger. The first section gives information how to obtain its log files.

Troubleshooting (last edited 2012-01-03 18:07:26 by ip-109-80-120-205)