LogoLogo
WherebyStatusCommunity
  • 📹Whereby 101
    • Create Your Video Experience
      • Get started in 3 steps
      • Embedding Whereby in a web app
        • Using Whereby's Web Component & Pre-built UI
          • Script Tags
          • With Low Code
            • Embedding in Squarespace or Wordpress
            • No code video conferencing in Bubble
        • Using Whereby's Browser SDK with React Hooks for a fully custom UI
      • Embedding Whereby in a mobile app
        • Embedding Whereby in iOS
          • Using Whereby's Native iOS SDK
        • Embedding Whereby in Android
          • Using Whereby's Native SDK
        • Using Flutter
        • Using React Native
      • Github SDK Examples
      • Meeting scheduling with Cronofy
    • Generating Room URLs
      • Name prefixes
      • Using “Create a room”
      • Using Postman
    • Customize Your Video Experience
      • During room creation
      • Using Attributes/URL Params
      • Global preferences
      • Branding elements
      • Dial-In
      • File sharing
      • Breakout Groups with Embedded
      • Waiting Rooms
    • User roles & Meeting Permissions
    • FAQ
      • Accessibility
      • Whereby Words
      • Firewall & Security
      • HIPAA compliant setup
      • Allowed Domains & Localhost
      • Whereby Embedded Feature Comparison
  • 🔍Meeting Content & Quality
    • Recording
      • Cloud Recording
      • Local Recording
    • Transcribing
      • Session Transcription
      • Recording Transcription
    • Live Captions
    • Session summaries
    • Live streaming RTMP
    • Quality Insights
      • Real-time troubleshooting
      • Using the Insights dashboard
      • Improving call quality
      • Tracking room events with Webhooks
  • 🤷End User
    • End User Support Guides
      • Supported Browsers & Devices
      • Screen Sharing Setup & Usage
      • Using Breakout Groups
      • Troubleshooting & Basics
  • 🚚Developer Guides
    • Quickly deploy Whereby to your domain
    • Tracking Customer Usage
    • Migrating from Twilio
      • Twilio JS SDK Quick Migration
      • Twilio JS SDK Direct Migration
  • 🖥️Reference
    • REST API Reference
      • /meetings
      • /insights
      • /recordings
      • /transcriptions
      • /summaries
      • /rooms
    • Web Component Reference
    • React Hooks Reference
      • Quick Start
        • Getting started with the Browser SDK
      • Guides & Tutorials
        • Migrate from version 2.x to 3
        • Grid logic
        • Custom Video Tiles with React
        • Usage with Next.js
        • How to customize the toolbar
      • API Reference
        • WherebyProvider
        • VideoView
        • VideoGrid
        • useLocalMedia
        • useRoomConnection
      • Types
    • React Native Reference
      • Quick Start
      • WherebyEmbed
    • Webhooks Reference
Powered by GitBook
On this page
  • Summary
  • Setup

Was this helpful?

Edit on GitHub
  1. Meeting Content & Quality
  2. Quality Insights

Real-time troubleshooting

Enhance users’ experience when issues arise with real-time monitoring and troubleshooting tools. These tools are free to use and by default switched on for all embedded customers.

Last updated 11 months ago

Was this helpful?

Summary

Video meetings depend on various factors. Some of them are within users' control - but only if they are aware of them. Typical root causes of audio and video issues include:

  • Poor or unstable internet connection

  • High CPU usage due to intensive software processes, running several applications at once, having numerous open browser tabs, or even aging device hardware

In order to help users deal with these issues, we provide a suite of real-time troubleshooting tools featuring:

  • Actionable tips for smoother meetings

  • Mode to conserve bandwidth and optimize audio quality by disabling videos

These tools allows participants and hosts to troubleshoot connection issues during calls, aiming to reduce your team’s support tickets and ensure high-quality experiences.


Meeting diagnostics

CPU usage monitoring is available exclusively for Chrome on desktop.

Users can easily access meeting diagnostics and check:

  • Overall performance

  • Audio transmission

  • Video transmission

  • CPU usage (exclusive to Chrome on desktop)

Detection of poor network conditions

  1. In case of poor network conditions, users see a notification and a red indicator appears

  2. Users can expand the panel to access more details and see actionable tips on how to improve the connection

  3. Meeting participants with poor network conditions will appear with an indicator on their video tile. This helps other participants understand why the affected participant's audio or video quality is lower.

Setup

If you already enable the Whereby top toolbar, you don’t have to do anything to enable as it will be on by default.

  • If you currently hide the Whereby top toolbar by using in URL parameter topToolbar=off - please remove this parameter.

  • If you currently hide the Whereby top toolbar by using the URL parameter minimal - please add a callQualityMonitoring=on parameter to the URL.

Is it possible to opt-out?

Yes, it’s possible to opt-out and remove this tool from your experience. We’ve built it to make both yours and your users experience smoother, but understand some of our customers may want to control access to this.

If you are using Whereby and want to opt-out of the meeting diagnostics tool, please supply callQualityMonitoring=off to the URL when embedding.

🔍
Meeting diagnostics
Detection of poor network conditions
Outlined in red is a new button that provides access to the Meeting diagnostics tools. Clicking this button opens the side panel.
Meeting diagnostics - example of poor connection.
A red indicator is visible next to the name of any participant experiencing connection issues.