We provide our customers with high-quality software and constantly monitor its quality. If you encounter any issues while using TrueConf products and you are not able to solve them by yourself, you can contact TrueConf technical support department. Apart from the detailed issue description, our managers may ask for some additional information in the form of log files. This article describes which logs may be required to identify and eliminate the issue.
Table of Contents
TrueConf Server
Log files are kept in the work path directory (С:\TrueConf by default for Windows OS or /opt/trueconf/server/var/log for Linux OS).
General Issues
One of the possible issues you might face is the inability to start TrueConf Server. Possible reasons are described in our blog. The main information about the TrueConf Server operation (start, restart, stop, etc.) is saved in the Stdout.log file located the in the work path directory for Windows OS, or /opt/trueconf/server/var/log/vcs/stdout.log for Linux OS. This data is useful to analyze such problems as:
- TrueConf Server cyclic restart
- «CHECK CERT: HW key is failed!» issue
- Active Directory connection error.
Problems with SMTP
If you face issues connecting to the SMTP server and sending email invitations, you can gather the information from the web_logs folder in the work path directory for Windows OS, or /opt/trueconf/server/var/log/webmanager for Linux OS.
Issues during Video Conferencing
There also might be certain difficulties during video meetings:
- video/audio delays or interrupts
- echo or extraneous noise
- reduced video quality
- users getting suddenly disconnected from the conference
- sudden conference end
- unexpected termination of TrueConf system services.
In the support ticket you need to specify the following parameters:
- The exact time of reproducing the issue
- TrueConf IDs of the users who had the issue
- Conference details:
- type of conference
- conference schedule
- number of invited/connected users
- How the users connect to the conference: via TrueConf client application or via WebRTC.
In addition, you need to attach the following logs:
- Stdout.log file and svc_logs folder from the work path directory for Windows OS, or the /opt/trueconf/server/var/log/vcs/svc_logs folder for Linux OS. It contains the logs about hosted video calls and conferences.
- transceiver_logs folder from the work path directory for Windows OS, or the /opt/trueconf/server/var/log/vcs/transceiver_logs folder for Linux OS. It contains logs about transcoding, mixing and transmitting the media data in calls with WebRTC, SIP/H.323/RTSP endpoints, RTSP streaming).
If TrueConf Server services crash, please also provide archived files from the dumps folder from the work path directory for Windows OS, or the /opt/trueconf/server/var/log/dump folder for Linux OS.
Problems During SIP/H.323/RTSP Calls
To identify and analyze the issues related to SIP/H. 323/RTSP endpoints call difficulties, you may need to install additional software called WireShark to capture traffic.
Possible problems might be:
- SIP/H.323/RTSP call interruption
- inability to call SIP/H.323/RTSP endpoint
- decreased audio/video stream quality
- interruption/loss of audio or video stream
- inability to display content on SIP/H.323 endpoints
- problems with SIP/H.323 gateway.
In this case additional TCP dumps need to be collected.
Collection of TCP dumps on Windows
- Install Wireshark on the computer where TrueConf Server is installed.
- Run Wireshark as an administrator.
- Start capturing packets and reproduce the problem you have specified in the support ticket.
- Once you’ve reproduced the issue, stop capturing packets and save the file by pressing the Ctrl+Shift+S combination.
Collection of TCP dumps on Linux
We recommend using the command-line tool tcpdump on Linux.
- Open the terminal (console).
- Install tcpdump. It is available right from the repository for most operating systems; for example, on Debian, you can install with this command:
1sudo apt install tcpdump
- Run one of the following commands as the administrator to capture the network traffic:
- coming through all network devices
1tcpdump -i any -w /path/dump.pcap
where
/path/dump.pcap
is the name of the file where dumps will be saved and the full path to this file if it will not be saved in the current folder; - coming through the selected network device
1tcpdump -i eth0 -w /path/dump.pcap
where
eth0
is the network card name in the OS. The commandip address
may be used to get the list of devices and their statuses.
- coming through all network devices
- While the console is still opened, press Ctrl + C to end dump collection and save dumps in the file specified above.
When submitting a ticket, attach the following logs to the ticket:
- .pcapng file with TCP dumps saved during the previous step (if Wireshark is used) or a .pcap file (when working with tcpdump);
- Stdout.log;
- gateway.pcap;
- svc_logs folder from the work path directory for Windows OS, or the /opt/trueconf/server/var/log/vcs/svc_logs folder for Linux OS;
- transceiver_logs folder from the work path directory for Windows OS, or the /opt/trueconf/server/var/log/vcs/transceiver_logs folder for Linux OS.
Also, you need to specify:
- the exact time of reproducing the issue
- TrueConf ID and/or IP address of the endpoint which you face the issue with.
Troubleshooting TrueConf Client Application
Possible problems are:
- incorrect application launch.
- instant or unplanned shutdown of the application.
- hardware compatibility issues.
If your desktop application crashes, please send an automatically generated crash email.
Otherwise, to collect logs, you need to complete the following steps depending on the operating system being used.
TrueConf for Windows client application
Get the configuration file of TrueConf client application:
- Run Command Prompt (cmd).
- Enter
"C:\Program Files\TrueConf\Client\TrueConf.exe" -hwtest
and press Enter. - Configuration file tc_configuration.txt will be generated in the current user folder (
C:\Users\
by default) under the path\AppData\Local\TrueConf\Client
.
Client application log files will be created automatically. You can find them in the following folder:
C:\Users\<username>\AppData\Local\TrueConf\Client\logs
To quickly access the folder C:\Users\<username>\AppData\Local\
type %localappdata%
in the explorer address bar and press Enter.
TrueConf client application for macOS
Get the configuration file of TrueConf client application:
- Proceed to
/Applications/Utilities
folder and run Terminal.app. - Open
/Applications
folder and find TrueConf Client.app. - Open the context menu and choose Show Package Contents.
- Drag TrueConf Client.app into the terminal.
-
Enter the parameter
/hwtest
at the end of the command and press Enter.Please note that during the configuration file creation, service information will be displayed in the terminal – this is normal behavior. - To extract the log file, enter tc_configuration.txt in the search field of Finder.
Client application log files will be created automatically. You can find them in the following directory:
Users/<username>/Library/Containers/org.trueconf.client/Data/Library/Application Support/TrueConf/Logs
/Library/
directory may be hidden by default. To access it, open the Finder application and select the Go → Go to Folder option in the menu. Enter ~/Library
in the pop-up window and click on Go.TrueConf client application for Linux
Get the configuration file of TrueConf client application. To do it, run Terminal, enter trueconf -hwtest and press Enter. Configuration file tc_configuration.txt will be created in the directory ~/
.
Client application log files will be created automatically. You can find them in the following directory: ~/.config/trueconf/logs
Please note that ~/.config
directory can be hidden by default and may not be displayed in the file manager. You may need to enable the display of hidden files in the file manager settings.
Problems with audio streams
If you are having problems when sending or receiving audio, you will need to check the Enable diagnostic audio dump box in the application settings to make sure that the cause of the problem could be correctly identified. If this box is activated, the working memory of the process related to audio streams will be saved in special files. This will make it much easier to identify and troubleshoot potential issues.
This feature may be helpful in multiple cases, for example:
- You or the person you are talking to are hearing echo.
- Some phrases cannot be heard due to interruptions.
- Audio and video are not synced.
- Stuttering can be observed.
- No audio is sent even though the speaker and microphone are turned on.
Memory dump files will be saved to:
- Windows – in the current user folder (by default
C:\Users\
) under the path\AppData\Local\TrueConf\Client
- Linux distros – in the directory
~/.config/trueconf/logs
- macOS – in the folder
Users/
./Library/Containers/org.trueconf.client/Data/
These files will have the .pcm extension. Besides, the .log file will be added to this folder; it will include detailed logs related to the work of audio devices.
If the audio problem occurs on a regular basis, you need to collect more detailed dump files. To do it, run the application with this parameter --log=1
and activate the checkbox Enable diagnostic audio dump. Use the application up until the moment when the problem is reproduced and attach .pcm and .log files to your request.
Problems with video file streaming
If you are having some difficulties when streaming a video file to a conference, you will have to attach the corresponding logs to technical support. On Windows, video streaming logs are stored by default in the current user folder (C:\Users\
\AppData\Local\TrueConf\Client\winExtensionsUWPlogs
When submitting a ticket to technical support, please provide the archive of the folder mentioned above.
TrueConf MCU
To download the archive with all system logs, click on the Administration tab in the TrueConf MCU control panel and select the Import/Export option. Next, go to the Server Logs tab and click the Export button. In the pop-up window, select the folder where the archive should be saved.
Additionally, when contacting technical support, you need to specify:
- Whether the MCU is registered on the SIP server or the H.323 gatekeeper.
- The protocol used in the call.
- In which direction the call was being made when you were collecting the information.
- Bitrate.
- The models and IP addresses of the devices used in the call.
TrueConf Room
TrueConf Room creates log files automatically in the following folder:
- Windows
C:\Users\<username>\AppData\Local\TrueConf\Room\logs
- Linux
/home/$USER/.config/trueconf/room/logs
In the case of a program crash, additional logs are created. You can find them by following the path:
- Windows
C:\Users\<username>\AppData\Local\TrueConf\Room\crashlogs
- Linux
/home/$USER/.config/trueconf/room/crashlogs
TrueConf Group
You can download the console and traffic logs of your TrueConf Group endpoint via its web interface.
To collect console logs:
- Restart the endpoint to remove unnecessary information from the log files.
- Reproduce the issue in question.
- Click the Settings button in the upper right corner of the web interface and select Diagnostics in the left sidebar.
- In the System log subsection, save the syslog, user.log, and vita.log files using the browser context menu.
You can start traffic capturing on the same page below:
- In the Network log subsection, press the Start button.
- Call the required user from your endpoint, or answer the call.
- When the call ends, click the Stop button.
For correct collection of traffic logs, the capturing should be started before the call, and stopped after the disconnection.
Download the logs by clicking the button to the right of the required file. To save multiple captures, check the boxes to the left of their ordinal number and click the Download selected traffic captures button.
In addition, when submitting a request to the technical support department, you need to specify:
- Whether the endpoint is registered on TrueConf Server or MCU.
- The protocol used during the call.
- In which direction the call was being made when you were collecting the information.
- Bitrate.
- Models and IP addresses of the devices used in the call.
TrueConf Kiosk
TrueConf Kiosk also automatically creates log files after every launch.
The path for the log storage:
C:\Users\<username>\AppData\Roaming\TrueConf\TrueConf SDK for Windows
TrueConf Tracker
To generate the log file during TrueConf Tracker operation, complete the following steps:
- Launch TrueConf Tracker.
- In a toolbar choose Tools – Show log.
- Reproduce the issue.
- After reproducing the issue, press Save and choose the folder to save the file.
TrueConf for Android
- Tap on the
button to open the main menu.
- Open the application settings.
- Go to the Advanced mode section and tap on the More button.
- Scroll down to the System log section and tap on the Start button.
- If you don’t need to test echo cancellation, just tap on the Start button; otherwise, activate the Echo debug switcher.
Then, try to reproduce the error you have encountered or just continue using the application until the error occurs.
If the problem is reproduced, take the following steps:
- Complete the log collection (in the same section). To do it, tap on the Finish button in the System log section.
- Tap on the Send button.
- Select a mail client (we recommend using Gmail). You can also add a comment describing what went wrong.
TrueConf for iOS/iPadOS
Sending application logs
- Open the TrueConf application on your device.
- Go to the Options → About section.
- Tap on the Share log file button.
- Select the mail client available on your device, e.g. Mail or Gmail.
- Describe the steps that led to the problem and send a request to crash@trueconf.com.
Sending crash logs
To send crash logs, take the following steps:
- Go to Settings→ Privacy→ Analytics & Improvements→ Analytics Data.
- Enter
trueconf
in the search field. The list will be updated. The names of crash log files will be formatted in this way: TrueConf-date-time.ips, for example:
1TrueConf-2022-11-24-205948.ips - Select the file and tap on the button
in the upper right corner of the screen.
- Describe the steps that lead to the problem and send your request to crash@trueconf.com.
To make sure that the logs are sent automatically, take the following steps:
- Go to the Settings→ Privacy → Analytics & Improvements.
- Activate the switcher Share iPhone Analytics (may also be called Share iPhone & Watch Analytics).