Java

Tracing and Logging
for JavaSE 6u10

Documentation Contents

Contents

Tracing

Tracing is a facility to redirect any output in the JavaTM Console to a trace file.

Java Plug-in

Tracing can be turned on by enabling the property javaplugin.trace. However, it turns on all tracing facilities inside Java Plug-in. To enable more fine-grained tracing, javaplugin.trace.option may be used. You can set trace-level options (0-5) in the Java Console, shown in the previous chapter, with the following meanings:

This enables tracing on the fly.

Another way to set fine-grained tracing is through the Java Control Panel. For instance, to enable tracing for everything (option 5 above), enter the following in the "Java Run Time Parameters" text field:

-Djavaplugin.trace=true
-Djavaplugin.trace.option=basic|net|cache|security|ext|liveconnect|temp

Tracing set through the Control Panel will take effect when the Plug-in is launched, but changes made through the Control Panel while a Plug-in is running will have no effect until restart.

Java Web Start

To set the initial trace level for a Java Web Start application set the deployment property deployment.trace.level. The deployment.trace.level property can have one of the following values:

To use all the tracing level set deployment.trace.level to all.

Logging

Similar to tracing, logging is a facility to redirect any output in the Java Console to a log file using the Java Logging API. To enable logging perform the following actions:

Other Options

File Names

The names of the trace and log files are

plugin<modified version number>.trace
plugin<modified version number>.log

where the <modified version number> includes the major, minor and patch version numbers; e.g., plugin142_06.trace or plugin150.log

File Locations

The default location (directory) of the trace and log files is:

where <User Application Data Folder> is as defined here.

If the environment variable USER_JPI_PROFILE is set to <user plugin home> then the trace and log files will be written to:



Copyright ©2008 Sun Microsystems, Inc. All Rights Reserved.
Feedback

Sun
Java Technology