Skip to main content

Analytics Dashboard: Metrics, Definitions, and Logic - Knowledgebase / VSee Clinic for Admins - VSee Health Helpdesk

Analytics Dashboard: Metrics, Definitions, and Logic

Authors list

This document serves as a central knowledge base for all metrics, calculations, and data points available within the Telehealth Analytics Dashboard. It is intended to align product managers, engineers, data analysts, and clinic administrators on the precise meaning and derivation of each data field.


Note: This feature is only available for user roles (i.e., Admin, Analyst) with access to Reports.


1. Introduction to the Dashboard Modules

The analytics dashboard is designed to provide multi-faceted insights into clinic operations, provider activity, patient behavior, and visit quality. It is organized into several key modules:

Number Widgets: A high-level overview displaying key performance indicators (KPIs) as individual cards, often with trend comparisons.

image-20260211-201146.png

Clinic / WR (Waiting Room) Utilization: A detailed view that breaks down the core Number Widget metrics by individual Clinic or Waiting Room.

image-20260211-203036.png

Utilization Graph: A time-series visualization (hourly, daily, monthly) of the core metrics, allowing for trend analysis over time.

image-20260211-203822.png

Clinic Report: A specialized report focusing on clinic-level data, including health readings from patient devices.

image-20260211-203152.png

Patient Flow & Feedback Modules: A set of tools to analyze patient drop-off points, reasons for leaving, and post-visit satisfaction through surveys and ratings.


2. Core Visit Statistics

This section defines the fundamental metrics related to patient visits.

2.1. Volume and Status Metrics

Field NameDefinition / Calculation LogicData Type
Total VisitsThe total number of visits. Group appointment: Each patient in the group is counted as an individual visit (e.g., a group of 5 patients counts as 5 visits). Note: This count does not include invited guests.Integer
Visits CompletedThe number of visits with a final status. Statuses Included: Pending Completed + Finalized.Integer
Pending VisitsA visit is considered pending if it is not in any of the following states: Missed, Aborted, Canceled, or Completed.Integer
Pending Completed VisitsVisits that are clinically finished but require additional action. Criteria: Pending Notes OR Pending Survey OR Pending Payment.Integer
Visit MissedA visit is marked as missed under two conditions:
1. Automatic: Patient is online, but the provider does not join. After the default system timeout (e.g., 4 hours), the visit is automatically marked as "Missed."
2. Manual: An admin or provider manually marks the visit as missed.
Integer
Canceled by PatientVisits that were canceled by the patient. (Previously labeled as "Aborted")Integer
Canceled by ProviderVisits that were canceled by the provider. (Previously labeled as "Canceled")Integer
Appt CreatedThe number of appointments created during the selected time period.Integer
Appt CompletedThe number of appointments completed during the selected time period.Integer

2.2. Time-Based Metrics

Field NameDefinition / Calculation LogicData Type
Avg Wait TimeThe average time a patient waits before connecting with the first provider (e.g., Doctor, CSR, MA). Calculation: Sum(Wait Time for all visits) / Count(Visits).Time
Avg Wait Time (Pro)Average wait time, filtered to only include visits where the first provider role is Provider or Doctor.Time
Avg Wait Time (MA)Average wait time, filtered to only include visits where the first provider role is Medical Assistant.Time
Avg Wait Time (CSR)Average wait time, filtered to only include visits where the first provider role is Customer Service Rep.Time
DurationThe sum of all patient call durations. Group appointment: Each patient's time in the call is calculated individually. Definition: The time from when a patient enters a call with a provider until the patient leaves the call.Time
Avg DurationThe average duration of a patient call. Calculation: Total Duration / Number of Patients.Time
Avg Duration (Pro)Average call duration, filtered to the provider role: Provider / Doctor.Time
Avg Duration (MA)Average call duration, filtered to the provider role: Medical Assistant.Time
Avg Duration (CSR)Average call duration, filtered to the provider role: Customer Service Rep.Time


2.3. Visit Modality and Type (Completed Visits Only)

Field NameDefinition / Calculation LogicData Type
Communication Method
VideoCount of completed visits where the communication method was Video.Integer
Phone VisitCount of completed visits where the communication method was Phone.Integer
In-PersonCount of completed visits where the communication method was In-Person.Integer
E-consultCount of completed visits where the communication method was E-consult.Integer
Visit Type
Walk-inCount of completed visits with the type Walk-in. Note: Walk-in, One to One, and Group are mutually exclusive. A walk-in session is counted here regardless of whether it was a group or individual session.Integer
One to OneCount of completed visits with the type One to One (scheduled individual session).Integer
GroupCount of completed visits with the type Group (scheduled group session).Integer
GuestsThe total number of guests who joined a call via an invite link.Integer


3. Operational & Clinical Metrics

This section covers metrics related to clinic activity, provider availability, and clinical data.

Field NameDefinition / Calculation LogicData Type
Active ClinicsA clinic is counted as active if it has had at least one visit during the selected time period.Integer
Active WRsA Waiting Room is counted as active if it has had at least one visit during the selected time period.Integer
Total ReadingsThe total count of health data readings (e.g., from blood pressure cuffs, glucose monitors). Calculation:
1. Identify active patients from the clinic.
2. Find the device IDs associated with those patients (filtered by the clinic's device_type) from device_logs.
3. Count all records in health_data that match either the device_id or user_id within the selected period.
Integer
Availability (Total)The total scheduled slot time for all providers. Calculation: Sum(slot time of provider 1 + slot time of provider 2 + ...). This includes slots for both 1-on-1 and group appointments.Time
Availability (Occupied)The total scheduled slot time that was filled by an appointment. Calculation: Sum(1-on-1 appt time + group appt time) for providers who have booked slots.Time
Availability (Available)The remaining available slot time. Calculation: Availability (Total) - Availability (Occupied).Time
Payment Collected ($)The total dollar amount of payments collected. This counts every visit, regardless of its status or type.Currency


4. Provider and Patient Analytics

This section defines metrics that focus on the users of the platform. Note: The labels for these roles are configurable per clinic (e.g., "Provider" can be "Specialist," "Physician," "Trainer"; "Patient" can be "Participant," "Client," "Trainee"). The underlying logic remains the same.

4.1. Provider Metrics

Field NameDefinition / Calculation LogicData Type
Total ProvidersThe total number of providers in the system.Integer
Active ProvidersThe number of unique providers who logged in or had any activity during the specified time period.Integer
Active Providers (with Visits)The number of unique providers who were part of at least one visit (regardless of the visit's final status) during the specified time period.Integer
Active RM (with Visits)The number of unique Remote Medics who were part of at least one visit.Integer
Concurrent ProvidersThe maximum number of providers who were active (e.g., in a call, logged in) at the same time during the specified time period.Integer

4.2. Patient Metrics

Field NameDefinition / Calculation LogicData Type
New PatientsThe number of unique patients who registered during the specified time period.Integer
Patients with VisitsThe number of unique patients who were part of at least one visit (regardless of the visit's final status) during the specified time period.Integer
Active PatientsThe number of unique patients who logged in or had any activity during the specified time period.Integer
Concurrent PatientsThe maximum number of patients who were active (e.g., in a call, in a waiting room) at the same time during the specified time period.Integer


5. Patient Journey & Feedback Analysis

These modules provide qualitative and quantitative data on the patient experience, from intake to post-visit feedback.

5.1. Drop-off Funnel

This funnel chart visualizes the patient journey and where drop-offs occur.

image-20260211-204229.png

The values represent the total number of drop-offs at each stage, calculated as a percentage of the baseline

Field NameDefinition / Calculation LogicData Type
IntakeAll drop-offs that completed the intake process. This represents the 100% baseline for the funnel.Percentage
Waiting for CallOut of the total drop-offs, the percentage of patients who entered the waiting room but dropped off before connecting with a provider.Percentage
Call ConnectedOut of the total drop-offs, the percentage of patients who connected with a provider but then voluntarily or involuntarily canceled before the session was completed.Percentage


5.2. Patient Drop-off Survey

This module captures feedback from patients who voluntarily cancel a call before connecting with a provider. A pop-up survey appears at the point of cancellation.

Donut Chart (Radio Responses): Displays the distribution of structured feedback. Results show the proportional breakdown of selected radio-button options (e.g., "Changed my mind," "Technical issues").

image-20260211-204516.png

Spreadsheet (Free-Text): A tabular view of the free-text responses entered by patients in the survey, providing unstructured, qualitative insights.

image-20260211-203303.png


5.3. Post-Visit Feedback & Ratings

These widgets capture feedback after a visit has ended.

Patient Post-Visit Review (Spreadsheet): A spreadsheet view of free-text feedback provided by the patient in a post-visit pop-up survey.

image-20260211-203645.png

This widget captures only text-box responses.

Provider Post-Visit Review (Spreadsheet): A spreadsheet view of free-text feedback provided by the provider in a post-visit pop-up survey.

Provider Rating: A star rating or score given by the provider about their experience during the video call.

image-20260211-204309.png

Patient Rating: A star rating or score given by the patient about their experience during the video call.

image-20260211-204346.png



Related Article:

How to Use the Analytics Dashboard


For further assistance, please contact us here.

Helpful Unhelpful