| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <html lang="en"> |
| <head> |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2019. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page."> |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| <link rel="STYLESHEET" href="../book.css" type="text/css"> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script> |
| <title>Tracing</title> |
| </head> |
| <body> |
| |
| <h1>Tracing</h1> |
| |
| <img src="../images/tracing_preferences.png" alt="Tracing preference page" border="0"> |
| |
| <p>The <a class="command-link" |
| href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.trace.tracingPage)")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> |
| <strong>General > Tracing</strong></a> preference page allows you to modify the tracing options of plug-ins dynamically.</p> |
| |
| <p>Plug-ins may provide OSGi tracing options that write out additional logging information when the appropriate flag is set. You |
| can set tracing options using a <em>.options</em> file. However, any changes to the flags require a restart.</p> |
| |
| <p>If a plug-in supports changing tracing options dynamically (without restarting) they will be listed on this preference page. The |
| changes will be made once <strong>OK</strong> is pressed.</p> |
| |
| <p>The <strong>Tracing output</strong> settings allow more control over where tracing messages are put. A different output file |
| can be chosen. A new file will be created each time the plug-in is started. If the maximum number of trace files stored has been |
| reached, the oldest file will be deleted. Setting a maximum trace file size prevents excessively large log files from being created.</p> |
| |
| <p>Not all plug-ins will write their trace messages to the output file. Some plug-ins instead write to console output or |
| perform other tasks.</p> |
| |
| </body> |
| </html> |