Difference between revisions of "Finding Log Files"

From Second Life Wiki
Jump to: navigation, search
(What are diagnostic logs?)
(Replaced content with "{{#Widget:Redirect|url=/t5/English-Knowledge-Base/How-to-report-a-bug/ta-p/733545}}")
Line 1: Line 1:
{{KBmaster}}
+
{{#Widget:Redirect|url=/t5/English-Knowledge-Base/How-to-report-a-bug/ta-p/733545}}
{{TOCright}}
+
== What are diagnostic logs? ==
+
 
+
Diagnostic logs, including crash logs, are a very important tool for debugging Second Life Viewer problems; they allow a developer to try to fix a bug that they've never personally witnessed.
+
 
+
Sometimes, our [http://secondlife.com/support Support] team will ask you to provide diagnostic logs while helping you with a support ticket. Support may ask you to provide specific logs; preferably, you can attach them to a support ticket, or if the contents are shorter, you can open them up in a text editor and copy-and-paste them into your ticket. If you're not sure, ask Support to clarify.
+
 
+
The Viewer can automatically submit crash logs to Linden Lab when the Viewer crashes, but external developers can't see them publicly. If you'd like the broader community to help find the bug that caused Second Life to crash on your computer, you can report the bug on the [[Issue Tracker]] and attach your crash logs.
+
 
+
{{KBnote|Second Life Viewer diagnostic log files are different from chat and IM logs.  See [http://community.secondlife.com/t5/English-Knowledge-Base/Text-chat-and-instant-messages/ta-p/700155#Section_.3 Text chat and instant messages] for more information chat and IM logs. }}
+
 
+
== Where do I find the logs? ==
+
 
+
You'll need to locate the <code>SecondLife</code> folder which contains the <code>logs</code> folder, and its location depends on your platform. '''[[User settings|See the "User settings" page]]''' for instructions.
+
 
+
In addition, platform specifics:
+
 
+
=== Windows 7 and Vista ===
+
 
+
{{KBtip|If you have problems finding this folder, try [http://www.voidtools.com/ Everything], a handy tool that searches ''everything'' on your hard drive by name.}}
+
 
+
The folder is usually located at <code>C:\Users\<username>\AppData\Roaming</code>. If you install Second Life in a different location, the path is different. In any case, to get to the right place:
+
 
+
# In Windows Explorer, click the '''[http://en.wikipedia.org/wiki/Start_button Start Button]'''.
+
# In the search field (in Windows 7, it's labeled "Search programs and files" and in Windows Vista, it's labeled "Start Search"), type <code>%appdata%</code> and press {{K|Enter}}.
+
# In the window that appears, open the <code>SecondLife</code> folder.
+
# see the logs folder for SecondLife.log, SecondLifeCrashReport.log and stack_trace.log
+
 
+
 
+
=== Windows XP ===
+
 
+
The folder is usually located at <code>C:\Documents and Settings\<username>\Application Data\SecondLife</code>. If you install Second Life in a different location, the path is different. To get to the right place:
+
 
+
# In Windows Explorer, click '''[http://en.wikipedia.org/wiki/Start_button Start button]'''.
+
# Click '''Run'''.
+
# In the Run window, type <code>%appdata%</code> and click '''OK'''.
+
#: [[File:Windows_XP_appdata.png]]
+
# In the window that appears, open the <code>SecondLife</code> folder.
+
# see the logs folder for SecondLife.log, SecondLifeCrashReport.log and stack_trace.log
+
 
+
 
+
=== Mac ===
+
* <code>/Users/<username>/Library/Application Support/SecondLife/logs</code>
+
 
+
In addition to the Viewer's own crash reporting, there's also:
+
 
+
* A general Mac OS X tool called [http://en.wikipedia.org/wiki/Crash_Reporter_%28Mac_OS_X%29 Crash Reporter]. [http://developer.apple.com/technotes/tn2004/tn2123.html More technical details.]
+
* A [http://en.wikipedia.org/wiki/System_Profiler_%28Apple%29 System Profiler] report, which contains all of the necessary data about your computer and the hardware inside of it. This is useful for Linden Lab to group problems with similar hardware.
+
*# In the Finder, choose '''Apple''' menu > '''About This Mac'''.
+
*# Click the '''More Info''' button to open the System Profiler.
+
*# In the System Profile, choose '''File''' > '''Save'''. Give the file a unique name so you can find it later, then attach it to your [[Issue Tracker]] bug report. Also [http://developer.apple.com/bugreporter/bugbestpractices.html see "Bug Reporting Best Practices" from Apple].
+
 
+
=== Linux ===
+
 
+
The folder is located at <code>~/.secondlife</code> - it's a hidden folder (the folder name begins with a dot) and it's inside the user home folder. To get here:
+
 
+
# Open your file manager
+
# go to your home folder
+
# if needed, enable "Show Hidden Files and Directories" or a similar option in your file manager
+
# open the <code>.secondlife</code> folder
+
# see the logs folder for SecondLife.log, SecondLifeCrashReport.log and stack_trace.log
+
 
+
 
+
==Log Files==
+
The Viewer creates the following list of log files in the logs folder where user data is stored. These are used for normal application logging, crash reporting, and so on.
+
=== SecondLife.log ===
+
Store for status and debugging output from the Viewer. This file continues to grow while Second Life is active and tends to become large. If too large it is trimmed by the crash logging application.
+
=== SecondLife.old ===
+
Upon initialization of logging for a Viewer session, the Viewer renames the existing SecondLife.log to SecondLife.old. SecondLife.old is used when the Viewer reports a freeze in the previous execution.
+
=== debug_info.log ===
+
This log is initialized after freeze reporting to contain information about the Viewer's state. When a crash is handled, additional information is added to this file about the state of the Viewer at the time of the crash. This log is the main source of non-crash stack data for viewer crash reporting.
+
=== SecondLifeException.log ===
+
This file stores raw callstack information from the Viewer. Its created during crash handling. It is deleted after freeze reporting so that future freeze reporting will not include any irrelevant call stack info.
+
[[Category:Operating system, hardware, and network]]
+
[[Category:Troubleshooting]]
+

Revision as of 13:18, 3 February 2012

Redirecting to http://community.secondlife.com/t5/English-Knowledge-Base/How-to-report-a-bug/ta-p/733545