Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 23 Next »

To allow for more advanced troubleshooting, it may be useful to observe Sharpen's debug mode console tracing, as well as Chrome Network logs. These logs allow for the population of more granular Q data within the console log including the socket event, currentlocation, queue call manager ID, caller ID, and timeliness of transactions. 

Instructions

Sharpen Debug Logging:

The first step in advanced browser troubleshooting is understanding how to get to the Chrome console logs. To gain access to the console logs, simply right click in the browser area and choose "Inspect".

You're there! Now onto the good stuff. To enable debug logging, it is important to consider which operating system you're running. Steps to enable debug mode are slightly different. Please follow the steps below depending on whether you're running Windows or MacOS.

Windows:

  1. Navigate to the appropriate view of Sharpen within app.sharpencx.com in a Chromium based browser

  2. Right-click in any empty space and choose "Inspect" 

  3. Choose the "Sources" tab

  4. Observe the pane on the right side of the screen and find the "Watch" sub panel

  5. Click the "+" button

  6. Enter localStorage.debug=true

  7. Hit Enter

  8. Refresh your browser

    1. You should notice a yellow panel/highlight across the top of your Q view. This indicates debug mode is on

  9. Navigate back to the console tab

  10. To toggle off, simply adjust the value to false

Mac:

  1. Navigate to the appropriate view of Sharpen within app.sharpencx.com in a Chromium based browser

  2. Click in an open space within the app

  3. Press Option - D on your keyboard

    1. You should notice a yellow panel/highlight across the top of your Q view. This indicates debug mode is on

  4. Right-click in any empty space and choose "Inspect" 

  5. Navigate to the "Console" tab

  6. To toggle off, simply press Option - D again

    1. The yellow bar should go away at this time

Enabling timestamps and log persistence in console logging:

Now, with debug mode enabled, we're getting more details events about Sharpen Q. The next step is to make sure time stamps are enabled so we can see when events are occurring.

  1. After inspecting the page, navigate to the "Console" tab.

  2. Look for the three vertical dots

  3. Next, choose settings

  4. Make sure both "Show timestamps" and "Preserve log upon navigation" are checked under Preferences>Console subsection.

  5. Make sure “Preserve log” is checked under the “Network” subsection.

Reproducing the issue:

Logging is all setup. We're ready to reproduce the issue. Upon every reproduction it is best practice to clear out the logging for the console and network tabs before getting started.

  1. Navigate to the "Console" tab

  2. Click the "Clear Console" button

  3. Navigate to the "Network" tab

  4. Click the "Clear" button

  1. Reproduce the issue

Saving the logs:

Once we've reproduced the issue, it is very important to download both the Console and Network logs before exiting the browser.

Saving console logs:

  1. Navigate to the "Console" tab

  2. Right-click in the log space

  3. Choose "Save As..."

  4. Leave the file name as is, and save to a known directory

Saving network logs:

  1. Navigate to the "Network" tab

  2. Click the "Export HAR" button

  3. Unlike the Chrome console log, the default file name does not contain a time stamp. Add a date/time reference to the file name and save to a known directory.

At this point you're ready to package the files and send them to Sharpen. Simply zip them up and send them to SharpenCare with the associated case.

Historic browser logging

If the issue you're experiencing does not happen on demand, or predictably, you may need to enable Chrome net-export logging to run in the background while you wait for the issue to occur. The steps are simple

  1. Open a new Chrome tab

    1. It is important you leave this tab open for the duration of your session and intended reproduction. If the tab is closed, logging will stop.

  2. Input chrome://net-export into the URL bar as shown below

  3. Click the large "Start Logging to Disk" button

  4. Choose a location to save the file and add a date/time designation to the filename

  5. Save

  6. Navigate back to your Sharpen tab and reproduce the issue

  7. Once you have reproduced the issue, navigate back to the "Network Log Export" tab and choose "Stop Logging"

  8. Navigate to the file directory you previously set and send the log to Sharpen 

  • No labels