DataPulse Documentation

Everything you need to install, configure, and run DataPulse Analytics.

Prerequisites

Requirement	Details
MQTTBridge	Must be installed and running with data flowing into SQL Server
Operating System	Windows 10/11 or Windows Server 2016+
.NET Runtime	.NET 10 ASP.NET Core Runtime (x64)
SQL Server	Same SQL Server instance used by MQTTBridge

Installation

Step 1: Ensure MQTTBridge is Running

DataPulse reads data from the MQTTBridge database. Make sure MQTTBridge is installed, connected to your MQTT broker, and storing messages.

Step 2: Run the DataPulse Installer

Download DataPulse-Setup.msi from the product page and run it. The installer will:

• Install DataPulse as a Windows service
• Create the DataPulse analytics tables (dp_ prefixed) in the MQTTBridge database
• Grant the service account database access
• Update the configuration with the detected SQL Server instance

Step 3: Start the Service

net start DataPulse

Or open services.msc, find "DataPulse Analytics Service", and click Start.

First Login

Open your browser and go to http://localhost:8090

Field	Default Value
Username	admin
Password	admin

DataPulse shares the same user credentials as MQTTBridge. If you changed the MQTTBridge admin password, use that same password here.

Dashboards

Dashboards are the main workspace in DataPulse. Each dashboard contains widgets that visualize your MQTT data.

Creating a Dashboard

1. Click "New Dashboard" from the dashboard list
2. Give it a name and optional description
3. Add widgets to visualize your data

Sharing Dashboards

Dashboards can be shared with other users. Toggle the "Shared" option on a dashboard to make it visible to all users.

Data Sources

Data sources define which MQTT topics DataPulse monitors. They use topic patterns to match messages from the MQTTBridge database.

Creating a Data Source

1. Go to Data Sources from the navigation
2. Click "Add Data Source"
3. Enter a name and topic pattern (e.g., sensors/temperature/#)
4. The data source will start pulling matching messages from the database

Topic Patterns

Pattern	Matches
sensors/#	All topics under sensors/
factory/line1/+	Any single level under factory/line1/
devices/temp	Exact topic match

Widgets

Widgets are the visual components on your dashboards. Each widget is connected to a data source and displays the data in a specific format.

Available Widget Types

Type	Use Case
Line Chart	Time-series data trends
Data Table	Raw message data with filtering
Heatmap	Density visualization across topics
Gauge	Current value display
Stat Card	Summary statistics

Adding a Widget

1. Open a dashboard
2. Click "Add Widget"
3. Select the widget type and data source
4. Configure the time range and any widget-specific settings
5. Drag and resize the widget on the grid

Anomaly Detection

DataPulse can automatically detect anomalies in your MQTT data and trigger alerts.

Creating an Anomaly Rule

1. Go to Anomaly Rules from the navigation
2. Click "Add Rule"
3. Select a data source and configure the detection parameters
4. Set up alert notifications (webhook URL)

Alert History

All triggered alerts are logged in the Alert History section with timestamp, severity, detected value, and notification status.

Licensing

Trial Mode

DataPulse runs in Trial mode for 7 days with limited features (3 dashboards). No license file needed.

Activating a License

1. Purchase a license from the pricing page
2. You'll receive a license key after purchase
3. In the DataPulse dashboard, go to the license activation panel
4. Enter your license key and click Activate

Troubleshooting

Service won't start

• Check that .NET 10 ASP.NET Core Runtime is installed
• Check the Windows Event Log for error details
• Verify port 8090 is not in use by another application
• Check the DataPulse log files in the install directory

No data showing in dashboards

• Verify MQTTBridge is running and storing messages
• Check that your data source topic pattern matches actual topics in the database
• Verify the database connection in appsettings.json points to the same SQL Server as MQTTBridge

Can't connect to database

• DataPulse uses the same MQTTBridge database. Verify it exists.
• Run Setup-SqlAccess.ps1 from the DataPulse install directory to fix permissions
• Check that the dp_ tables exist in the database

Dashboard not accessible at localhost:8090

• Verify the service is running: sc query DataPulse
• Check if another application is using port 8090
• Try http://127.0.0.1:8090