IoTHubX Documentation

Official guide for the Real-time Azure IoT Hub Visualization Platform.

IoTHubX is a powerful dashboard designed to simplify the monitoring and management of Azure IoT Hub resources. It provides real-time telemetry visualization, device health insights, and simulated data capabilities for development and testing.

System Overview (Dashboard)

The main dashboard provides a high-level view of your IoT ecosystem health and performance.

Real-time Stats

Monitor total connected devices, message throughput, and active warnings in real-time. Cards update via SignalR push notifications.

Device Map

Geospatial visualization of device locations based on reported twin properties or simulated metadata.

Device Management

Important Platform Limitation:
  • Read-Only Integration: Connections to Azure IoT Hub are strictly Read-Only. This platform simply monitors existing telemetry.
  • No Edit/Delete on Cloud: Creating, Editing, or Deleting devices on the Azure IoT Hub is NOT supported.
  • Simulator Scope: All "Add Device" or "Edit Device" actions performed in this dashboard apply only to the internal Device Simulator/Platform for testing purposes.
Device Details View

Clicking on any device opens the detailed inspection view:

  • Real-time Charts: Live line charts showing telemetry data points as they arrive (e.g., Temperature, Humidity).
  • Data Tables: Tabular view of recent messages with sortable columns.
  • Column Filtering: Use the "Select Columns" dropdown to customize which data fields are visible in the table.
  • Payload Inspection: Switch between "Table View" and "Tree View" (JSON) to inspect raw payload schemas.
  • Full Screen Mode: Maximize the chart area for deeper analysis.

Telemetry Grid

A unified view of all incoming messages across your entire workspace.

Data Retention

Historical data availability in the grid depends entirely on your Azure IoT Hub's configured retention period (default is usually 1 day for basic tiers).

Live Filtering

Filter messages by Device ID, Component Name, or specific value ranges to isolate anomalies.

Telemetry Generator

A built-in tool for load testing and simulation.

  • Purpose: Sends Dummy/Simulated Data to your configured IoT Hub.
  • Usage: Useful for testing alerts, dashboard throughput, and stream analytics jobs without requiring physical hardware.
  • Configuration: Define custom payload templates (JSON) and transmission intervals.

Stream Analytics

This feature helps you build and test logic using Simulated Data Sources.

Create query jobs to process data streams in real-time. Note that this feature currently operates on the internal simulated stream and does not deploy jobs to Azure Stream Analytics resources.

Reports & Insights

Overview Report

Summary of all system activities and key performance indicators.

Device Health

Analysis of device connectivity status, last seen times, and potential failures.

Connectivity

Deep dive into connection dropouts, retry attempts, and signal stability.

Security & Ops

Audit logs of user actions and security alerts related to device access.

Security & Configuration

Connection Security
  • Masked Credentials: Connection strings are masked (e.g., `SharedAccessKey=******`) for all non-admin users.
  • Permission Badges: The system parses your connection string to display exactly what permissions are granted (e.g., `RegistryRead`, `ServiceConnect`).
Role-Based Access
  • Admins: Full access to connection strings and platform configuration.
  • Users/Guests: Read-only access to dashboards and reports. Connection tokens valid only for active session.