Plugins 〉LinkSmart SensorThings


Developer

Fraunhofer FIT

Sign up to receive occasional product news and updates:


Grafana Cloud
ObservabilityCON on the Road: Chicago (Mar 11)

See demos of new Grafana Cloud observability workflows, hear community success stories, and leave with what you need to advance your observability roadmap.


This plugin is no longer maintained. Consult the Grafana documentation and plugin catalog to discover potential alternatives.
Data Source
community

LinkSmart SensorThings

  • Overview
  • Installation
  • Related content

Grafana OGC SensorThings Plugin

This plugin enables the visualization of sensor and location data from an OGC SensorThings server on Grafana.

It provides:

Demo

A live dashboard showing SensorThings data in Grafana panels: SensorThings Dashboard

Installation

Install via grafana-cli

sudo grafana-cli plugins install linksmart-sensorthings-datasource

Install from source

git clone https://github.com/linksmart/grafana-sensorthings-datasource.git linksmart-sensorthings-datasource
  • Restart Grafana server to see the newly added datasource.

Setup

  1. Go to Grafana Configuration.
  2. Select Add data source.
  3. Provide the necessary details to connect with OGC SensorThings server.
NameDescription
NameThe data source name.
DefaultSet this as the default plugin for new panels.
TypeChoose SensorThings Datasource.
UrlOGC SensorThings API root URL (e.g. http://localhost:8080/v1.0). Note the URL has no trailing slash ("/").
AccessProxy: Let Grafana server proxy the requests to OGC SensorThings API server.
Basic AuthAuthenticate to OGC SensorThings API server (if required, provide User and Password)

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

Query Configuration

Graph view

To visualize the observations from OGC SensorThings server,

  1. Add a graph panel.
  2. Select the SensorThings Datasource.
  3. Select Sensor or Things to get the list of sensors or things which are available in your SensorThings server.
  4. Select a specific sensor or thing from the list, to get the list of datastreams.
  5. Select a datastream to visualize the observations in the graph.

See the demo below for better understanding:

Table view

Using table view, one can see list of observation recorded based on Sensors/Things, and also list of Locations visited by a Thing or list of Things that has been in a specific Location.

  1. Add a table panel.
  2. Select the SensorThings Datasource.
  3. Select Sensors, Things, Locations, or Historical Locations from the initial dropdown list.

See the demo below for better understanding:

World Map view

Using world map view, one can see the current Location of a Thing on the map.

  1. Install world map panel from grafana plugin store.

  2. Add a world map panel in dashboard

  3. In "Worldmap" tab:

    • Select Center->Last GeoHash
    • Set Min Circle Size and Max Circle Size to 5
    • Select Location Data->json result
  4. In "Metrics" tab:

    • Select the OGC SensorThings Datasource.
    • Select a "Thing" from dropdown list.

See the demo below for better understanding:

Dev setup

npm install
npm run watch

Links

Installing LinkSmart SensorThings on Grafana Cloud:

For more information, visit the docs on plugin installation.

Installing on a local Grafana:

For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.

1. Install the Data Source

Use the grafana-cli tool to install LinkSmart SensorThings from the commandline:

grafana-cli plugins install 

The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.

2. Configure the Data Source

Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.

Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.

To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.