Difference between revisions of "Finding Log Files"

From Second Life Wiki
Jump to navigation Jump to search
Line 1: Line 1:
{{KBmaster}}
{{KBmaster}}
{{TOCright}}
{{TOCright}}
== Log File Locations ==
== What are diagnostic logs? ==
The location of log files depends on your operating system:
 
* '''Windows''' - In folder options, choose to show hidden files/folders.
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.
** '''XP''': <code>C:\Documents and Settings\<username>\Application Data\SecondLife\logs</code>
 
** '''Vista and Windows 7''': <code>C:\Users\<username>\appdata\roaming\SecondLife\logs</code>
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.
* '''MacOSX''' - <code>/Users/<username>/Library/Application Support/SecondLife/logs</code>
 
* '''Linux''' - <code>/home/<username>/.secondlife/logs</code>
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.
 
== 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 ===
 
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==
==Log Files==

Revision as of 07:36, 9 December 2011

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 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.

Where do I find the logs?

You'll need to locate the SecondLife folder which contains the logs folder, and its location depends on your platform. See the "User settings" page for instructions.

In addition, platform specifics:

Windows 7 and Vista

KBtip2.png Tip: If you have problems finding this folder, try Everything, a handy tool that searches everything on your hard drive by name.

The folder is usually located at C:\Users\<username>\AppData\Roaming. If you install Second Life in a different location, the path is different. In any case, to get to the right place:

  1. In Windows Explorer, click the Start Button.
  2. In the search field (in Windows 7, it's labeled "Search programs and files" and in Windows Vista, it's labeled "Start Search"), type %appdata% and press Enter ↵.
  3. In the window that appears, open the SecondLife folder.
  4. see the logs folder for SecondLife.log, SecondLifeCrashReport.log and stack_trace.log


Windows XP

The folder is usually located at C:\Documents and Settings\<username>\Application Data\SecondLife. If you install Second Life in a different location, the path is different. To get to the right place:

  1. In Windows Explorer, click Start button.
  2. Click Run.
  3. In the Run window, type %appdata% and click OK.
    Windows XP appdata.png
  4. In the window that appears, open the SecondLife folder.
  5. see the logs folder for SecondLife.log, SecondLifeCrashReport.log and stack_trace.log


Mac

In addition to the Viewer's own crash reporting, there's also:

  • A general Mac OS X tool called Crash Reporter. More technical details.
  • A 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.
    1. In the Finder, choose Apple menu > About This Mac.
    2. Click the More Info button to open the System Profiler.
    3. 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 see "Bug Reporting Best Practices" from Apple.


Linux

The folder is located at ~/.secondlife - it's a hidden folder (the folder name begins with a dot) and it's inside the user home folder. To get here:

  1. Open your file manager
  2. go to your home folder
  3. if needed, enable "Show Hidden Files and Directories" or a similar option in your file manager
  4. open the .secondlife folder
  5. 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.