How to Troubleshoot HiveMQ Web Client Issues

If you're encountering issues with the HiveMQ Web Client—such as connection errors, invalid credentials, or no message activity—this guide outlines key troubleshooting steps to assist with diagnosis and support.

Instructions

1. 📁 Record a HAR File

Capturing a HAR (HTTP Archive) file while reproducing the issue allows the support team to inspect network activity and identify what’s going wrong in the browser.

👉 Follow this guide:
https://hivemq.atlassian.net/wiki/x/GID7mw

⚠️ Please review and remove any sensitive information before sharing the file.

2. 🎥 Record a Short Video (Optional but Recommended)

A screen recording that shows the steps you take and any errors you encounter can greatly speed up diagnosis.

Use any screen recording tool
Upload the video to a secure file sharing service
Share the link when contacting support

📨 Contacting Support

When reaching out to HiveMQ Support, please include:

The HAR file (cleaned)
The video (if available)
Web Client URL and error details
Your Cluster ID

✅ Summary

Recording a HAR file and optional screen video are the most effective ways to troubleshoot Web Client issues. These artifacts enable HiveMQ Support to quickly diagnose and resolve your issue.