Site KPI Dashboard: Guide

Site KPI Dashboard: Guide

Overview

The Site KPI Dashboard offers real-time and historical insights into site, gateway, and sensor health metrics, plus additional features.

It enables users to:

  • Analyze and compare site, sensor, and gateway metrics across past months or quarters, with optional comparison to a specific date

  • View the latest sites summary snapshot

  • Track metrics trends over time

  • Generate downloadable reports (CSV / Markdown / PDF)

  • View details of connected / disconnected / total sensors and gateways

  • Monitor site health across total, connected, degraded, and critical states


Access & Permissions

If the Site KPI Dashboard card is not visible:

  • User likely does not have access yet

  • Request access from admin, or

  • Grant access via the Admin Panel (Refer: Section 8 - Providing Dashboard Access to Users HERE)


3. Dashboard Views

Users can toggle between the two views from the top-right section of the dashboard.

3.1 Comparison View (Primary)

This is the main analytical view of the dashboard. It allows analysis of metrics across past months or quarters, with an optional comparison to a specific date. This view is powered by a system that captures daily metric snapshots at 7 AM PT, ensuring consistency across reporting.

  • Monthly metrics → Use last snapshot within that month

  • Quarterly metrics → Use last snapshot within that quarter

Capabilities

  • Switch between Monthly and Quarterly views

  • Select predefined or custom time ranges

  • Optionally compare against a specific date

  • Compare data in tabular format

  • Visualize trends using charts

  • Download CSV / Markdown / PDF reports

Screenshots

📸 Site KPI Dashboard Landing Page (select Monthly / Quarterly)

 

📸 Comparison View - with “compare to specific date” enabled (extra column added to table)

 

📸 Comparison View - Trend charts showing metrics over time

 


3.2 Site Details (Today) View

This view provides a snapshot of the current state of sites in the system.

  • Displays:

    • Count of total, connected, degraded and critical sites

    • Count of total / connected sensors and gateways

    • Site-wise metrics with total, connected and disconnected sensors and gateways

    • Tabs to segregate connected, degraded and critical sites

  • Mirrors the daily email - “Site KPI Report” (7 AM PT)

  • Shows the real-time data on load

  • Refresh functionality to fetch latest data

  • Download table data for analysis

 

📸 Site Details (Today) view


How to Use (Comparison View)

  1. Open the Site KPI Dashboard

  2. Choose ‘Monthly’ or ‘Quarterly’ comparison

  3. Comparison View opens by default

  4. Select a time range (it excludes current/ongoing month or quarter):

    • Quick options (e.g., last 3, 6, 12 months or last 1–4 quarters)

    • Or select a custom range

  5. (Optional) Select Compare past months' or quarters' metrics to a specific date? checkbox and select a date

    • If data exists, an additional column is added in the table for metric comparison

  6. Review:

    • Metrics table

    • Trend charts

  7. Download reports if needed (CSV / MD)

  8. Use Refresh to reload the latest data


Data & Snapshot Logic for Comparison View

  • Data is captured as daily snapshots at 7 AM PT

  • Monthly metrics → Use last snapshot within that month

  • Quarterly metrics → Use last snapshot within that quarter

  • Current (incomplete) month/quarter is excluded

  • Historical snapshots have been backfilled from Dec 23, 2025

This ensures the dashboard serves as a reliable and consistent source of truth.


Points to Note

  • Charts and tables are always aligned to selected filters and ranges

  • Large ranges may enable horizontal scrolling

  • All reports include a UTC timestamp for traceability


Conclusion

The Site KPI Dashboard provides a unified view of both current and historical system performance, enabling teams to track trends, compare metrics across time periods, and perform point-in-time analysis with ease. With built-in reporting, visualization, and alignment to daily snapshots, it serves as a single, consistent source of truth for operational insights.