How to gather and submit logs from the BlackBerry 10 smartphone or BlackBerry PlayBook tablet

Article ID: KB26038

Type: Support Content

Last Modified: 09-30-2014

 

Product(s) Affected:

  • BlackBerry 10
  • BlackBerry PlayBook
  • 4G LTE BlackBerry PlayBook
CollapseEnvironment
  • BlackBerry 10 smartphones
  • BlackBerry PlayBook tablet
CollapseOverview

As part of standard troubleshooting, BlackBerry Technical Support Services may request submission of logs from the BlackBerry 10 smartphone or BlackBerry PlayBook tablet. The Help application allows for easy submission of this information from these devices, which helps minimize the time required to diagnose and troubleshoot issues.

Logs are fully encrypted and only BlackBerry Technical Support Services representatives have the ability to decrypt and view the submitted logs. For more information on what is contained in the logs, see the Additional Information section.

For steps to submit the log file, choose the solution for the scenario that applies:

BlackBerry Link can also be used to obtain logs from the device. For more information, see KB34114.
 


Scenario 1: Submit logs using the Help application

If an Internet connection is available on the device and an Incident Number (for example, INC000012345678) has been provided, use the following steps to submit logs using the Help application.

Note: The device PIN must be associated with the Support Ticket in order to successfully submit logs. If this has not yet been completed, contact BlackBerry Technical Support Services.

On the BlackBerry 10 smartphone:

Note: For BlackBerry 10 smartphones with BlackBerry Balance enabled, logs can only be submitted from the personal space. For more information, see KB33790.

BlackBerry 10 OS version 10.3:

The following are two methods that can be used to gather logs using BlackBerry 10 OS version 10.3. If an issue is easily reproducible, you can use the Log Streaming method to begin logging, reproduce the symptom(s), and then stop logging (Note: When the Log Streaming method is used, the log file size will be increasingly large until it is stopped.)

Method 1 - Log Snapshot

  1. Open the Help application.
  2. Swipe down from the top of the screen and tap Create Report.
  3. Tap the Snapshot tab.
  4. Tap the Save Log Snapshot button.
  5. Once the capture is complete, the device prompts to Upload Logs. If you have an existing support ticket and the device is connected to the Internet, click Yes. If not, click No.
  6. See the option that applies:
    • If Yes was selected:
      1. Enter your email address.
      2. Enter the support ticket number you were provided.
      3. Tap Next, then Submit.
    • If No was selected:
      1. The notification message closes and the log collection screen is displayed.
      2. The Log Snapshots are automatically saved and can be found on the device memory in the Logs folder under Device\Documents\

Method 2 - Log Streaming

  1. Open the Help application.
  2. Swipe down from the top of the screen and tap Create Report.
  3. Tap the Streaming tab.
  4. Enable the appropriate the appropriate streaming content:
    • System Logs
    • Clear System Log History
    • Radio Logs
    • Kernel Event Logs
  5. For the Save Location, choose either Device or SD card depending on the amount of free memory available.
  6. Tap Start Log Streaming, then perform the actions necessary to reproduce symptom(s).
  7. When finished, tap Stop Streaming.
  8. The logs will be saved in the format bbswltLog<date and time> and can be found in the one of the following locations (as selected in step 5 above):
    • Device\bbswlt\
    • Media Card\bbswlt\

BlackBerry 10 OS version 10.2:

  1. Open the Help application.
  2. Swipe down from the top of the screen and tap Create Report.
  3. In the Incident Number field, enter the support ticket number you were provided.
  4. In the Email Address field, enter the email address that was used to open the support ticket.
  5. Tap Report.
  6. Once the report is completed, press Send.

BlackBerry 10 OS version 10.0 or 10.1:

  1. Open the Help application.
  2. Complete one of the following:
    • On BlackBerry 10 OS version 10.0, tap the Support tab, then tap Create Report.
    • On BlackBerry 10 OS version 10.1, tap the Home icon on the bottom-left, then tap Support > Create Report
  3. In the Incident Number field, enter the support ticket number you were provided.
  4. In the Email Address field, enter the email address that was used to open the support ticket.
  5. Tap Report.
  6. Once the report is completed, press Send.

On the BlackBerry PlayBook tablet:

  1. Open the Help application.
  2. Swipe down from the top bezel and select Support.
  3. On the left side, select Log Submission.
  4. In the Incident Number field, enter the support ticket number that you were provided.
  5. In the Email Address field, enter the email address used to open the support ticket.
  6. Tap Create Report.
  7. Once the report is completed, press Send.

Note: An IT Policy can restrict the functionality of submitting logs from the tablet, see KB29942 for more information.



Scenario 2: Submit logs using an email from the BlackBerry device

If an Internet connection is available on the device, but an Incident Number has not been provided, use the following steps to submit logs as an email attachment sent from the BlackBerry device.

On the BlackBerry 10 smartphone:

Note: For BlackBerry 10 smartphones with BlackBerry Balance enabled, logs can only be submitted from the personal space. For more information, see KB33790.

  1. Open the Help application.
  2. Complete the following:
    • For BlackBerry 10 OS version 10.0, tap Support > Create Report.
    • For BlackBerry 10 OS version 10.1, tap the Home icon > Support > tap Create Report.
    • For BlackBerry 10 OS version 10.2, Swipe down from the top bezel > tap Create Report.
  3. In the Incident Number field, enter INC000012345678.
  4. in the Email Address field, enter an email address.
  5. Tap Report.
  6. Once the report has been generated (Note: Do not press Send), exit from the Help application by swiping up from the bottom of the screen.
  7. Open the File Manager app and tap Documents > Logs.
  8. Look for the .pb file formatted as <Date><Time>-<incident_number>.pb (for example, 20110720193715-INC000012345678.pb).
  9. Touch and hold the file and in the right-hand action menu tap the Share option.
  10. Select an email account to send from.
  11. Send the email with the .pb file attached to the desired address.

On the BlackBerry PlayBook tablet:

  1. Open the Help application.
  2. Swipe down from the top bezel and tap Support.
  3. On the left side, select Log Submission.
  4. In the Incident Number field, enter INC000012345678.
  5. in the Email Address field, enter an email address.
  6. Tap Create Report.
  7. Once the report has been generated (Note: Do not press Send), exit from the Help application by swiping up from the bottom of the screen.
  8. Open Messages and compose an email message to the email address to which the log file is to be sent.
  9. Attach the .pb log file. The file can be found under Documents\Logs. Look for the file formatted as <Date><Time>-<incident_number>.pb (for example, 20110720193715-INC000012345678.pb).
  10. Send the email message.

Scenario 3: Submit logs from a computer

If an Internet connection is not available on the device, use the following steps to submit logs as an email attachment sent from a computer.

On the BlackBerry 10 smartphone or BlackBerry PlayBook tablet:

  1. Complete the steps as described in Scenario 1 above for the specific device, except for the last step. The last step of sending the report will fail since there is no active Internet connection.
  2. Follow KB26068 to enable Storage and Sharing.

On the Computer:

  1. Connect the device to the computer and open the corresponding removable drive from within Windows Explorer (for example: Z:\).
    Note: When using a Mac computer, the BlackBerry PlayBook tablet will not appear as a removable drive, but as a network share with an IP address such as 169.254.x.x. See KB26068 for details.
  2. Navigate to <drive>:\documents\logs and copy the file formatted as <Date><Time>-<incident_number>.pb (for example: 20140720193715-INC000012345678.pb) to a location on the computer.
  3. After the log file has been extracted to a computer, perform one of the following steps:
    • Attach the log file to an email using a mail client (for example, Microsoft Outlook) or web-based email account (for example, Gmail) and send the message to help@blackberry.com.
      Note: If the support ticket number is known (for example, INC000012345678), be sure to include it in the Subject field of the message.
    • Upload the log file using the BlackBerry Log Submission form available at www.blackberry.com/go/nalogs.
CollapseAdditional Information

BlackBerry Link can also be used to obtain logs from the device. For more information, see KB34114.

Contents of device logs

The logs contain information about the BlackBerry device such as the BlackBerry PIN number, memory status, system and size and usage, hardware ID, operating system and platform, device model, battery status, Wi-Fi, radio or wireless strength and connections, list of installed applications, a well as other information. To review this information before sending it to BlackBerry Technical Support, click View Additional Details within Support.

Other logs generated and sent to BlackBerry Technical Support Services may contain additional technical information that is collected in a form that does not identify a user, such as the BlackBerry device's operating system and environment information, data regarding processes running and device configuration, system events, videos and music file information, and other data regarding the condition of the BlackBerry device at the time the log is generated.

Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.