mqtt-diagnosis

Diagnose MQTT publishing issues between CaptureLora.py and mqtt_grid_web.py.

Updated Oct 21, 2024
One-click install
npx skills add https://github.com/fulviomanente/IQRight_Local --skill mqtt-diagnosis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mqtt-diagnosis
Source: https://github.com/fulviomanente/IQRight_Local/tree/main/.claude/skills/mqtt-diagnosis
Command: npx skills add https://github.com/fulviomanente/IQRight_Local --skill mqtt-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose MQTT publishing issues between CaptureLora.py and mqtt_grid_web.py. Check topic distribution, connection stability, and cross-reference with web app logs. Use when messages aren't reaching the web interface.

Core Features & Use Cases

  • Publish success rate analysis: compute MQTT-TX success vs failure from logs to gauge reliability.
  • Topic distribution checks: extract and validate topics (e.g., Class96, IQRSend) and detect known malformed topics for bug tracking.
  • Connection stability and web cross-reference: collide MQTT connectivity with web app logs to ensure end-to-end data flow.
  • Use Case: When the web UI isn't receiving data, run this diagnosis to determine whether the server, topics, or web subscriptions are at fault.

Quick Start

Run a diagnostic pass over logs and classify issues to guide remediation.

Frequently Asked Questions about mqtt-diagnosis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why are MQTT messages not reaching my web interface?

MQTT messages may not reach the web interface due to publish failures between CaptureLora.py and mqtt_grid_web.py, connection instability, or malformed topics. Cross-referencing broker logs with web app logs isolates the responsible component.

How do I troubleshoot MQTT publish success rate and connection stability?

Troubleshoot MQTT publish success rate by computing MQTT-TX successes versus failures from daemon debug logs, checking topic distribution for known malformed topics, and colliding MQTT connectivity data with web app logs to confirm end-to-end data flow stability.

What's the best way to diagnose IoT MQTT broker issues using log correlation?

The best way to diagnose IoT MQTT broker issues is correlating logs from logs/IQRight_Daemon.debug with web application logs to determine whether connectivity drops, topic distribution errors, or web subscription failures are preventing data delivery.

How can I detect malformed MQTT topics causing web UI data delivery failures?

Detect malformed MQTT topics by extracting and validating topic names like Class96 and IQRSend from publish logs, then flagging known malformed topic patterns for bug tracking to resolve web UI data delivery failures.

Does MQTT diagnosis work without external dependencies or broker configuration?

MQTT diagnosis works without external dependencies by analyzing existing log files from the IQRight_Daemon debug output and web app logs, requiring no additional broker configuration or installed packages to classify publish issues.