voximplant KitDocs
  1. Getting started
  2. Troubleshooting
  3. Guide for collecting data to troubleshoot the Kit softphone app
Rate this page:

Guide for collecting data to troubleshoot the Kit softphone app

The Kit softphone app is an application you install on your PC (Windows, Mac, Linux) to make and receive calls from anywhere on your desktop using Voximplant Kit telephony.

If you encounter an issue with the app, its logs can help support specialists quickly identify and resolve the problem.

In this article, you will find a step-by-step guide on how to collect logs and other information about the app for bug analysis and troubleshooting.

Contents

Copy URL

Developer tools setup

Copy URL

App logs record all user actions in chronological order. Log entries will help support staff understand the root cause of an issue more quickly and find workarounds and possible fixes.

Before downloading debug logs you need to set up developer tools.

Note

The developer tools are configured once beforehand. No re-configuration is required.

  1. Expand the tray menu and right-click the Kit softphone app icon (on Windows machines).
  2. Click Open console.
Open console on Windows

To open the console on macOS machines, click the app icon in the topbar and select Open console from the menu.

Open console on macOS

The app console opens.

Console
  1. Click the console settings icon.
Console settings
  1. Select the Preserve log checkbox.
Preserve log

Collecting logs

Copy URL
Important

Collect logs immediately after detecting a bug so that the bug events are not replaced with new log entries. We recommend that you collect logs in the first minutes after a bug occurrs.

  1. In the console window, right-click any log line and select Save as… in the menu.
Information

There is no need to select specific log lines. When you select the Save as… option, all current records will be saved.

Saving log
  1. Save the log file to your PC for future investigation.
Saving log

Recording bug meta information

Copy URL
  1. Record your app version or make a screenshot of the tray menu.
App version
  1. Note the time the bug occurred and the user's timezone.
  2. Indicate whether any tabs of the Voximplant Kit web app or other softphones were open at the time the bug occurred, where the user was logged in.
  3. Specify the user's operating system version (Windows 7/8/10/11 or MacOS and version).
  4. If the bug is reproducible and visible, take a screenshot or screen recording.

Submitting data to support

Copy URL

After collecting the required data, submit it to support specialists for analysis and bug fix.

  • Log file

  • Bug details (including bug occurrence time)

  • Kit softphone app and operating system versions

  • Whether the user was simultaneously logged into the Voximplant Kit web app or softphones

  • Screenshots and recordings (if any)

Troubleshooting update installation errors

Copy URL

If you encounter an error while installing updates for the app on Windows OS, you need to delete the folder with the old version of the application and install the updated app.

  1. Open File Explorer.
  2. Select View > Options > Change folder and search options.
  3. On the View tab, under Advanced settings, select Show hidden files, folders, and drives.
  4. Click OK.
  5. In the tray menu, right-click the Kit softphone app icon and select Log out.
  6. Delete the folder at: C:\Users\\AppData\Local\Programs\kit-softphone-electron.
Note

You may need Administrator permissions to delete the folder.

  1. Install the new version using the link.