README.md

LinkSmart HDS - Grafana Datasource Plugin

Grafana datasource plugin for LinkSmart Historical Datastore (HDS).

Please refer to this page for the plugin's compatibility with different HDS versions.

Sample Dashboard

Installation

Installation of latest official release

Using grafana-cli:

sudo grafana-cli plugins install linksmart-hds-datasource

If using Grafana Docker Image, set container environment variable instead:

GF_INSTALL_PLUGINS=linksmart-hds-datasource

Install from source

Clone the repository into Grafana's plugin directory and restart grafana:

git clone https://github.com/linksmart/grafana-hds-datasource.git linksmart-hds

If using Grafana Docker Image, set container environment variable instead:

GF_INSTALL_PLUGINS="https://github.com/linksmart/grafana-hds-datasource/archive/master.zip;linksmart-hds-datasource"

you can replace the master branch with the version of your choice.

Configuration

Plugin Configuration

1. Go to Grafana Configuration.
2. Select Add data source.
3. Select LinkSmart HDS Datasource
4. Provide the necessary details (see below figure) to connect with OGC SensorThings server.

Name	Description
Name	The data source name.
Default	Set this as the default plugin for new panels.
Url	The URL of the HDS instance. (Default port is 8085)
Access	Server (Default): Let Grafana server proxy the requests to HDS. \ Browser: Send requests directly from client browser.
Whitelisted Cookies	Not applicable for this datasource
Basic Auth	Authenticate to HDS (if required, provide User and Password)

5. Save & Test, you should see this confirmation:

Query Configuration

Name	Description
Metric	The ID and name of the metric (HDS Datasource)
Source	The measurement, aggregates, and retention policy (Preconfigured at HDS)

Development

Build the source

npm install 
npm run build

Sample HDS for Demonstration Purposes

To run Historical Datastore in demo mode (with continuously growing dummy senml data)

docker run -p 8085:8085  linksmart/hds -demo -conf /conf/docker.json