Debug Help

From Second Life Wiki
Jump to: navigation, search

This page's purpose is to make it easier for you to provide us with info to help fix bugs. You may be asked for the following details by a Linden so we can help you further, so bookmark this for future reference.

How do I send crash logs?

This is done automatically in current viewers.

Note that when the Crash Reporter is active, it may go slowly as it sends us your info. This is normal.

How do I find my system information?

Where do I find my SecondLife.log file?

IMPORTANT: This log contains your computer's system info and some local directory paths. It does not contain any personal/private account data, but if you feel uncomfortable providing the aforementioned publicly on the Issue Tracker, say so in the corresponding issue's comments in order to facilitate a Linden receiving it privately.

Windows XP

The log file is usually in a directory like this:

C:\Documents and Settings\[YOUR USERNAME]\Application Data\SecondLife\logs

NOTE: [YOUR USERNAME] refers to the one used to identify you on your computer, not your Second Life Resident name.

Windows Vista, Windows 7 and Windows 8

The log file is usually in a directory like this:

C:\Users\[YOUR USERNAME]\AppData\Roaming\SecondLife\logs

NOTE: [YOUR USERNAME] refers to the one used to identify you on your computer, not your Second Life Resident name.

Your drive letter may vary depending on your setup, but C: is the most common.

To get there:

  • Windows Vista: Click the taskbar's Start button > Run, then next to "Open:" type %appdata% and click OK.
  • Windows 7: Click the taskbar's Start button > All Programs > Accessories > Run, then next to "Open:" type %appdata% and click OK.
  • Windows 8: Tap the taskbar's Start button (or the Windows key), type %appdata%, then press Enter ↵.

Scroll down and look for the "SecondLife" folder, then inside that, open the "logs" folder.

Mac OS

The log file will usually be in a directory like this:

/Users/[YOUR USERNAME]/Library/Application Support/SecondLife/logs
KBtip2.png Tip: Can't find your Library folder on OS X Lion or later? While in the Finder, hold down the Opt ⌥ key, and pick Go>Library from the top menu.

Linux

The log file is located in:

~/.secondlife/logs/

where ~ is your home/user directory.

How do I get my Fast Timers results?

Fast Timers are a set of scrolling bars which separate Second Life's resource usage into colored chunks. This is very useful for identifying if a certain category is using far more computer power than it should, and helps us pinpoint problems. It may look overwhelming at first, like something out of Star Trek, but as long as you can take a good screenshot and send it to us, that's what matters.

First, you'll need the Develop menu on. Press:

  • Ctrl+Alt+Q on Windows and Linux.
  • Ctrl+Opt ⌥+Q on Mac.

You should see it appear in the menu bar, to the right of the Help menu.

Once it's open, go to Develop menu > Consoles > Fast Timers. Like this:

Develop-Consoles-Fast-Timers.png

You should see the bars appear, with an animated line graph below.

Fast Timers.jpg

Each bar corresponds to a frame, so if your performance is slow, the bars will animate slowly too. (You can try going to a busy area with many avatars and compare that to being in a quiet place with no one else around.)

Feeling dizzy? Click on or near the bars to freeze the chart.

You can click on labels to expand/contract them and show a more detailed breakdown, which Lindens may ask you to do depending on the situation. For example, if you click twice on "Render" — once to hide, once to open — it goes from this:

Fast Timers - Render - closed.png

to this:

Fast Timers - Render - open.png

This shows a breakdown of what's using the most "Render" time, which is helpful in diagnosing graphics-related slowdowns.

Then, you can do the next step, which is to take a screen capture. There are a number of ways to do this:

Using Second Life's built-in tools

  • Click Snapshot button on the toolbar, or pick World>Snapshot from the menu.
  • Click "Save to My Computer".
  • Click the >> button to reveal Advanced Options.
  • Check "Interface" in the Capture section.
  • You should see a little preview which shows the your screen shot. Click the round arrow button so that the fast timer bars show.
  • Click Save button. The first time you do this during a session, it'll ask you where you want to save the picture. Go ahead and save it somewhere you'll remember.

Using external tools

No matter what method you use, the important thing is making sure the whole Fast Timers are clearly visible.

Next, if you saved the file as a BMP or another large filetype, you'll want to compress the image into a web-friendly format to get a good balance of detail and filesize. This can generally be done like this:

  • Open the file in the image editor.
  • Go to File menu > Save As.
  • Select "JPG" as format. You may may see an additional option to choose quality — preferably, the compressed image should be less than 500 KB, so aim for about 50-75% quality.

If you're not sure what to use, try Paint on Windows or Preview on Mac. On very old versions of Windows or with very old viewers, XnView may work out better than Paint.

Attaching the screenshot to an issue

See the Bug Tracker to file a new issue, there will be a spot to add attachments on the form.

You can also attach images to an existing issue. If they're in a web-friendly format like JPG, there'll also be thumbnail previews for convenience. See an example.

VWR-1478.png

All you have to do is:

  • On the left side, click "Attach file to this issue". A form will appear.
  • Click Browse button and locate the image where you saved it.
  • Enter a comment as appropriate — it could simply say, "Here are my Fast Timers results.", and click Attach button.
  • Wait a few seconds, and if it succeeded, you'll end up back on the issue's main page, now showing your attached Fast Timers screenshot.

For power users

If you know what you're doing, you don't even have to save to disk: a much quicker way is to capture the screen to clipboard, then on the issue's main page, click "Attach screenshot to this issue" and click Paste button. It should appear in the preview box, then you can customize the file name, make a comment, then attach it.

Related, see JIRA maker Atlassian's documentation.

We've also got a more comprehensive and technical explanation of Fast Timers. Learn more.