Skip to content

Commit e3ea0f5

Browse files
committed
update limitation in README
1 parent d0ba304 commit e3ea0f5

File tree

1 file changed

+14
-3
lines changed

1 file changed

+14
-3
lines changed

README.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,12 +18,21 @@ The MQTT data source has the following requirements:
1818
- The plugin currently does not support all of the MQTT CONNECT packet options.
1919
- The plugin currently does not support TLS.
2020
- Including multiple topics in a panel is not yet well supported.
21-
- This plugin automatically supports topics publishing json formatted messages.
22-
21+
- This plugin automatically supports topics publishing very simple JSON formatted messages. Note that only the following structure is supported as of now:
22+
```
23+
{
24+
'value1': 1.0,
25+
'value2': 2,
26+
'value3': 3.33,
27+
...
28+
}
29+
```
30+
We do plan to support more complex JSON data structures in the upcoming releases. Contributions are highly encouraged!
31+
- This plugin currently attaches timestamps to the messages when they are received, so there is no way to have custom timestamp for messages.
2332
## Install the plugin
2433

2534
### Installation Pre-requisites
26-
Refer to: [Building a Backend Datasource Plugin](https://grafana.com/tutorials/build-a-streaming-data-source-plugin/)
35+
Refer to: [Building a Streaming Datasource Backend Plugin](https://grafana.com/tutorials/build-a-streaming-data-source-plugin/)
2736
### Installation Steps
2837

2938
1. Clone the plugin to your Grafana plugins directory.
@@ -34,6 +43,8 @@ Refer to: [Building a Backend Datasource Plugin](https://grafana.com/tutorials/b
3443

3544
This plugin currently supports MQTT v3.1.x.
3645

46+
__Note: Since this plugin uses the Grafana Live Streaming API, make sure to use Grafana v8.0+__
47+
3748
### Verify that the plugin is installed
3849

3950
1. In Grafana from the left-hand menu, navigate to **Configuration** > **Data sources**.

0 commit comments

Comments
 (0)