luneski/mqtt-explorer

Fork 0

Files

Thomas Nordquist 1a8f64966c Update readme

2019-03-05 14:10:14 +01:00

5.2 KiB

Raw Blame History

MQTT Explorer

Version {{ version }}

A MQTT Tool to get a quick overview of your MQTT topics and integrate new devices/services more efficiently.

Visualize topics and topic activity
Delete retained topics
Search/filter topics
Delete topic recursively
Publish topics
Plot numeric topics
Keep a history of each topic

MQTT-Explorer strives to be THE swiss-army-knife tool. The perfect tool to integrate new services, IoT devices in your network. The hierarchical view allows for a quick understanding what is going on on your broker.

Download

Platform		Downloads
	Windows	{{windowsTargets}}
	Linux	{{linuxTargets}} Run AppImage: Make it executable and double-click it.
	Ubuntu	Ubuntu Store
	Mac	{{macTargets}}

More Downloads

Screenshots

Demo

Performance

This App is optimized to handle thousands of topics and at hundreds of thousands messages per minute.

In very large productive environments brokers may handle an exteme load of topics. Subscribing with a wildcard topic is in this scenario not adviced. To avoid a scenario where the MQTT-Explorer would have to handle millions of updates, one can set up custom subscriptions in the "Advanced" connection settings.

Develop

PRs and issues are welcome

Install with npm run install, build with npm run build

Start with npm run start

The app directory contains all the rendering logic, the backend directory currently contains the models, tests, connection management.

Automated Tests

To achieve a reliable product automated tests run regulary on travis.

Data model
MQTT integration
UI-Tests (The demo is a recorded ui test)

Telemetry

No personal data is processed, sent or stored.

The app sends telemetry and error reports, this enables me to quickly react on bugs/errors and understand what's going on. The app runs on winows, linux and mac and has thousands of users. Responding quickly to bugs is essential. This greatly helps to improve the software quality and reliability.

It basically sends: app version, processor architecture, operating system, used memory, user interactions and error stacks.

Example telemetry

{ system: { arch: 'x64', platform: 'darwin' },
  appVersion: '0.0.7',
  events: { HELLO_EVENT: [ 1547714886134 ] },
  now: 1547714886135,
  transactionId: '1767d251-f492-4f2c-aa62-88add3acc26b' }
{ errors:
   [ { time: 1547714887921,
       message: 'He\'s dead Jim!',
       stack:
        'Error: He\'s dead Jim!\n    at ./src/tracking.ts.exports.default (./mqtt-explorer/app/build/bundle.js:142765:11)\n    at new Promise (<anonymous>)\n    at Object../src/tracking.ts (./mqtt-explorer/app/build/bundle.js:142764:1)\n    at __webpack_require__ (./mqtt-explorer/app/build/bundle.js:20:30)\n    at Object../src/index.tsx (./mqtt-explorer/app/build/bundle.js:142618:1)\n    at __webpack_require__ (./mqtt-explorer/app/build/bundle.js:20:30)\n    at ../backend/node_modules/charenc/charenc.js.charenc.utf8.stringToBytes (./mqtt-explorer/app/build/bundle.js:84:18)\n    at ./mqtt-explorer/app/build/bundle.js:87:10' } ],
  now: 1547714887921,
  transactionId: '53bf9aac-e695-40cc-9a81-b1cf3398843d' }

Even thoug the data is purely technical, an option to disable telemetry is planned. #52

License

AGPL 3

5.2 KiB Raw Blame History