Inspector Reference (Public Beta)

Use this page to look up Inspector's controls, metrics, timeline events, and limits. For a walkthrough, see the Inspector Guide.

Search and Meetings List

The main search accepts a Session ID or an Issue ID returned when your application reports an issue through the Video SDK.

Meetings list shows session and application IDs, error and user counts, status, start and end times, duration, media mode, recording status, and saved-session information.

Filter	Meaning
Minimum users	Minimum number of users in a result.
Application ID	Application associated with the session.
In progress	Entries whose recorded status is in progress.
Errors (>3)	Entries with four or more errors.
Recently inspected (<3 days)	Entries opened in Inspector within the last three days.
Media Mode	Routed, relayed, or unknown.
Time Range	A preset or custom time range.

Use the column controls to sort results. The Saved column displays saved names and tags; these aren't searchable.

Control	Effect
Time zone	Selects the time zone used to display session data.
Session range	All available meetings or an individual meeting within the session.
Aggregated	Summary graphs for connections, publishers, and subscribers. Individual-user selection is disabled in this view.
Per User	Details for up to four selected users at a time, including quality graphs and Events Timeline.

Summary and User Data

Meeting summary shows IDs, duration, start times, saved-session details, and features used in the session. Meeting statistics lists users, connections, streams, subscriptions, and usage totals. A single user can have several connections and streams.

Total streamed minutes includes published and subscribed media time, with a breakdown in its tooltip. Accounts with the Advanced Insights add-on also see Total participant minutes.

User data lists each user's Inspector label, location, system, SDK, and GUID. Expanding a user shows their connection IDs, timing, end reasons, and publisher and subscriber streams.

The GUID identifies a client endpoint. Your application's connection and stream records can help you match it to a participant.

Quality Metrics

These graphs are available in Per User. Their audio/video and stream filters vary:

Graph	What it describes
Bitrate	Media data rate, displayed in kbps. Audio, video, and combined values depend on the selected filter.
Packet Loss	Percentage of media packets reported lost for the selected stream and media type.
MOS Score	Mean opinion score estimates for receivers, based on audio and video measurements reported by the client.
Latency	Round-trip time (RTT), displayed in milliseconds.

See Graphs and Metrics for help reading the graphs, comparing streams, and selecting a time range.

Bitrate, Packet Loss, and Latency can display a dashed threshold line. Hover over its marker to see the value and explanation. Bitrate below the threshold may indicate reduced stream quality; packet loss or latency above their thresholds may indicate degraded quality or network delay. A threshold can fall outside the graph's visible range.

Graph colors identify streams. The MOS graph has no threshold lines and needs receiver measurements to display scores.

Events Timeline

Events Timeline shows connection, publishing, and subscribing activity for the users selected in Per User. Entries mark individual events or periods of activity.

Under each selected user, the timeline groups their connection, published streams, and the subscribers receiving those streams. Each row's tooltip identifies the activity:

Row	Details available in its tooltip
Connection	Connection ID, connection/disconnection times, and duration. Client and network details can include SDK, browser/OS, device, session mode, transport protocol, connection type, network type, and region.
Publisher	Stream ID, media source, published media, and timing. A row can include several stream instances, with IDs for each interval.
Subscriber	Subscription and stream IDs, media source, published media, the requested subscription, timing, and client details.

Fields depend on the data recorded for the session. Network type and region, for example, may be absent.

Event tooltips show the User, Outcome, Type, IDs, and measurements. Instant entries have a timestamp; Duration entries have a start, end, and duration. When a tooltip groups several events or intervals, expand the list to see their individual timings and gaps.

Use Pin to keep a tooltip open and Copy to copy its contents.

Category	Example entries
Session and Connection Stability	Reconnection and ICE-restart activity.
Network Performance Issues	Bandwidth limited resolution, Publisher bitrate, and Subscriber Media Link Statistics.
System Performance	CPU overload events, CPU limited resolution, and Media device availability.
Media Quality Metrics	Subscriber resolution and frame rate, audio and video quality scores, and Video layer availability.
Media Quality Issues	Audio fallback events, Audio fallback transitions, Video freeze, and Video pause.

Connection and Recovery

Reconnection tracks attempts to restore the client's session connection. ICE restart tries to find a working network path for audio or video after a connection problem. ICE stands for Interactive Connectivity Establishment; it can restart while the participant remains in the session.

The attempt's outcome is unknown if no success or failure was recorded. Expand grouped entries in the tooltip to see the individual attempts and their recorded outcomes.

Publisher Conditions

These entries describe the publisher's outgoing media. Bandwidth limited resolution and CPU limited resolution require evidence of an active subscriber.

The publisher statistics guide explains the underlying client measurements, including video layers and quality limitation reasons.

Entry	Meaning
Bandwidth limited resolution	The publisher reports that bandwidth is limiting its video resolution.
CPU limited resolution	The publisher reports that CPU load is limiting its video resolution.
Publisher bitrate	Total reported bitrate across video layers, with outcomes including Low bitrate, Very low bitrate, and No video.
Audio fallback transitions	Changes between normal publishing, Video at risk, and Audio fallback as congestion worsens or clears.
Video layer availability	Active video layers and their dimensions, bitrate, codec, and scalability mode. The tooltip compares the active layer count with the maximum observed for that stream.
Media device availability	Audio/video configuration and device details at a publishing attempt. Outcomes include Audio and video, Audio only, and No media.

Receiver Conditions

Under a publisher, each subscriber row represents a user receiving that publisher's stream. The tooltip identifies the receiver, publisher, and stream.

Subscriber resolution gives the received image's width and height. Subscriber frame rate includes received and preferred FPS. Labels such as Choppy video and Frozen describe the measurements; compare their values with the application's requested settings and the type of content, such as camera video or screen sharing.

Video freeze and Video pause show counts and durations reported by the receiver. An interval can include several short freezes or pauses. Its tooltip gives the count and total frozen or paused time.

See subscriber statistics for definitions of the receiver's measurements, including freezes and pauses.

Audio quality score and Video quality score show receiver quality estimates over time, which you can compare with the MOS graph.

Audio fallback events track subscriber video warnings and changes between enabled and disabled states. Outcomes include Video at risk, Audio fallback, and recovery.

CPU overload events track changes in the reported CPU performance state, including Fair, Serious, and Critical.

Subscriber Media Link Statistics shows the reported Local network condition, Remote network condition, and Network degradation source. Outcomes include Fair network, Network degraded, and Critical network. The local and remote values help locate which side of the connection had trouble. See Network Condition for the client-side scores and reported causes.

Intervals, Colors, and Missing Measurements

Some entries come directly from client events. Others are calculated from periodic quality samples, so their start and end times follow those samples. For example, Inspector uses quality measurements to identify Network Performance Issues, such as low bitrate or bandwidth limitations. These conditions can appear on the timeline without a corresponding Event Log entry, because Event Log lists recorded events.

An entry's color reflects its severity, such as Warning, Degraded, or Critical. Its tooltip gives the values and timing for that connection or stream.

Some conditions exclude an initial startup period or require an active subscriber. Inspector skips missing measurements rather than substituting zero, so gaps can occur when there isn't enough data to calculate an interval.

Error Log

Error Log lists failures with their code, name, description, time, and user information. In Per User, it shows errors for the selected users.

Event Log

Event Log lists individual records with the user, time, event type, severity, status, description, and payload. Expand a row to read its payload.

Filter	Meaning
Keyword	Searches the event name, description, user label, source, and severity. All added keywords must match. Payload contents are excluded.
Severity	Info, Warning, or Error.
Status	Success, Failure, or Attempt.
Client and Server	Source of the event record.

Severity is the level assigned to an event; Status is the operation's progress or result. For example, a record can have severity Info and status Attempt. A normal client disconnect can also have severity Info.

Download exports event records as JSON. Filtered exports records matching the log filters; All data includes records those filters exclude. Both options use the selected meeting and users.

Other Session Features

Feature	Inspector information
SIP Interconnect	SIP user details and dedicated quality graphs when SIP records are present.
Live Captions	Captions activity for publishers and subscribers, including available language information.
Interactive Broadcast	Broadcast identifiers, type, status, resolution, duration, and start/end times. Multiple broadcasts can be selected individually.
Recording (Archiving)	Recording indicator and access to the separate Archive Inspector.

Missing Data and Limits

Session data is available for 20 days. New data usually takes about five minutes to appear in Inspector. Save a session before its data expires if you need to keep it longer.

When you look up a reused Session ID, Inspector shows data for up to seven dates. Other meeting dates may be missing from the results even while their data is still within the 20-day retention period. Use a new Session ID for each meeting to avoid this limit.

Situation	What to check
No session found	Check the ID, access to its application, and whether its data is still retained.
Quality graphs are absent in Aggregated	Switch to Per User for individual quality graphs.
More than four users to inspect	Per User lets you compare up to four users at a time. Change the selection to inspect other participants.
No data for a user or stream	Check the meeting, selected users, and graph filters. The client may also have missing records.
Events Timeline unavailable on an older saved session	Older saves may lack the records required by the timeline. Reopening uses the same saved data, so the timeline remains unavailable. Graphs and logs can still be used.

Common Questions

Why do the summary counts differ from the users I selected? Summary counts cover the whole session. A user can also have several connections and streams, so the totals for each measure can differ.

How do I match User 1 or a GUID to a participant? Look up the connection and stream IDs in your application's logs. Location and device details can help narrow the search.

How do I find an older saved session? In Meetings list, set Time Range to All time and clear other filters. Use the name and tags in the Saved column to recognize it, or search by Session ID or Issue ID.