| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
| "http://www.w3.org/TR/html4/loose.dtd"> |
| <html lang="en"> |
| <head> |
| <meta name="copyright" content= |
| "Copyright (c) IBM Corporation and others 2012. 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=utf-8"> |
| <title>Error Log</title> |
| <script language="JavaScript" type="text/javascript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script> |
| <link href="../book.css" rel="stylesheet" type="text/css"> |
| </head> |
| <body> |
| <h1>Error Log</h1> |
| <p>The <strong>Error Log</strong> view captures all the warnings and errors logged by plug-ins. The underlying log |
| file is a <em>.log</em> file stored in the <em>.metadata</em> subdirectory of the workspace. The <strong>Error |
| Log</strong> view is available under <a class="command-link" href= |
| 'javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.pde.runtime.LogView)")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="Open the Log view"> <strong>Window > Show View > |
| Error Log</strong></a> .</p> |
| <p><img src="../images/error_log.png" alt="Error Log"></p> |
| <h2>Event Sorting</h2> |
| <p>Events in the log view can be sorted by <strong>Message</strong>, <strong>Plug-in ID</strong> or |
| <strong>Date</strong> in ascending or descending order. Simply click on the column header that you want the sorting |
| to be based on. The down arrow in the column header indicates descending order; while, the up arrow indicates an |
| ascending order.</p> |
| <h2>Event Grouping</h2> |
| <p>Events in the log view can be grouped by <strong>Session</strong> or <strong>Plug-in ID</strong>. Simply click on |
| the chevron from the view's toolbar and select <strong>Group By</strong>.</p> |
| <h2>Event Filtering</h2> |
| <p>You can filter the view to show events of a particular type or session. Also, you can limit the number of entries |
| in the view. Filtering options are available under <strong>Filters...</strong> from the view's toolbar drop down |
| menu.</p> |
| <h2>Import and Export Logs</h2> |
| <p>To <strong>import</strong> an arbitrary <em>.log</em> file into the view, press the <strong>Import Log</strong> |
| toolbar button or select <strong>Import Log...</strong> from the context menu. Then, choose a <em>.log</em> file from |
| the file system.</p> |
| <p>To <strong>export</strong> the current log view content into a file, press the <strong>Export Log</strong> toolbar |
| button or select <strong>Export Log...</strong> from the context menu. Then, enter a file name.</p> |
| <h2>Clear and Delete Logs</h2> |
| <p>To <strong>clear</strong> the view log content without deleting the underlying <em>.log</em> file, press the |
| <strong>Clear Log</strong> toolbar button or select <strong>Clear Log Viewer</strong> from the context menu.</p> |
| <p>To permanently <strong>delete</strong> the underlying <em>.log</em> file, press the <strong>Delete Log</strong> |
| toolbar button or select <strong>Delete Log</strong> from the context menu.</p> |
| <h2>Event Details</h2> |
| <p>Full details about a particular event can be viewed in the <strong>Event Details</strong> dialog by |
| double-clicking on a particular entry or selecting <strong>Event Details</strong> from the context menu of that |
| entry. You can view the <strong>Date</strong>, <strong>Severity</strong>, <strong>Message</strong>, <strong>Exception |
| Stack Trace</strong> (if available) and <strong>Session Data</strong> of each event.</p> |
| <p><img src="../images/error_log_details.png" alt="Error Log Details"></p> |
| <p>You can navigate from one entry to the next via the <strong>Up</strong> and <strong>Down</strong> arrow |
| buttons.</p> |
| <p>To copy the error to the clipboard, press the button with the clipboard image.</p> |
| </body> |
| </html> |
