You can debug a GrapeCall by accessing the url “/call/debug” on your installation.
You must have super user rights to access this page.
A cleaner runs periodically and checks from GrapeCalls that have wrong finish status.
The Self Test Page should be enabled on your installation.
The Self Test Page provides a way to quickly check for common issues that might make your Grape Call experience not so nice.
It can be accessed through the proper button on any Grape Call:
Then, a new tab will open and you will see some tests for the common issues. The page currently looks like:
Those are the tests currently performed:
Grape specific tests¶
Checks if the browser is supported
Checks the microphone is able to produce 2 seconds of non-silent audio
Computes peak level and maximum RMS
Mono mic detection
Check WxH resolution
Checks the camera is able to capture at the requested resolution for 5 seconds
Checks if the frames are frozen or muted/black
Detects how long to start encode frames
Reports encode time and average framerate
Check supported resolutions
Lists resolutions that appear to be supported
Verifies it can talk with a turn server with the given protocol
Verifies it can gather at least one IPv6 candidate
Verifies connections can be established between peers through a TURN server
Verifies connections can be established between peers through NAT
Verifies connections can be established between peers with the same IP address
Establishes a loopback call and tests data channels throughput on the link
Establishes a loopback call and tests video performance on the link
Measures rtt on media channels
Measures bandwidth estimation performance (rampup time, max, average)
By default calls between 2 participants are done peer-to-peer. This means the connection is directly between the clients and ignoring the Videobridge (Grapecall server).
In some environments, especially when all users are using a VPN, this can lead to unforeseeable connection issues.
In order to turn peer-to-peer off follow these steps:
Add a new config file on your grapecall server:
Put this into the file:
config.p2p.enabled = false;
restart the web container:
docker restart grapecall_web_1