WebRTC troubleshooter provides a set of tests that can be easily run by a user to help diagnose WebRTC related issues. The user can then download a report containing all the gathered information or upload the log and create a temporary link with the report result.

• Microphone
  • Audio capture
    • Checks the microphone is able to produce 2 seconds of non-silent audio
    • Computes peak level and maximum RMS
    • Clip detection
    • Mono mic detection
• Camera
  • 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
• Network
  • Udp/Tcp
    • Verifies it can talk with a turn server with the given protocol
  • IPv6 connectivity
    • Verifies it can gather at least one IPv6 candidate
• Connectivity
  • Relay
    • Verifies connections can be established between peers through a TURN server
  • Reflexive
    • Verifies connections can be established between peers through NAT
  • Host
    • Verifies connections can be established between peers with the same IP address
• Throughput
  • Data throughput
    • Establishes a loopback call and tests data channels throughput on the link
  • Video bandwidth
    • Establishes a loopback call and tests video performance on the link
    • Measures rtt on media channels.
    • Measures bandwidth estimation performance (rampup time, max, average)

Due to their time duration they are not part of the normal test suite and need to be run explicitly.

• Network latency
  • Establishs a loopback call and sends very small packets (via data channels) during 5 minutes plotting them to the user. It can be used to identify issues on the network.

Pull requests and issues welcome! See CONTRIBUTING for instructions. All contributors must sign a contributor license agreement before code can be accepted. Please complete the agreement for an individual or a corporation as appropriate. The Developer's Guide for this repo has more information about code style, structure and validation.

Make sure to install NodeJS and NPM before continuing. Note that we have been mainly been using Posix when developing TestRTC hence developer tools might not work correctly on Windows.

npm install

bower update

grunt

Cleans out/ folder if it exists else it's created, then it copies and vulcanizes the resources needed to deploy this on Google App Engine.

grunt build

python dev_appserver.py out/app.yml

python google-cloud-sdk/platform/google_appengine/dev_appserver.py --host=0.0.0.0 --enable_host_checking=false out/app.yaml

python google-cloud-sdk/platform/google_appengine/dev_appserver.py --host=0.0.0.0 --enable_host_checking=false --ssl_certificate_path=cert/server.crt --ssl_certificate_key_path=cert/server.key out/app.yaml

Help to generate certificate: https://labsys.frc.utn.edu.ar/wiki-seguridad/src/contenedor.php?id=14&tipo=algoritmo

gcloud app deploy out/app.yaml