Plugins 〉FROST SensorThings API Plugin


Developer

Fraunhofer IOSB

Sign up to receive occasional product news and updates:


Grafana Cloud
Grafana Cloud
  • Grafana, of course
  • 10k series Prometheus metrics
  • 50 GB logs
  • 50 GB traces
  • 2,232 app o11y host hours
  • ...and more
Create free account

No credit card needed, ever.


Data Source
community

FROST SensorThings API Plugin

  • Overview
  • Installation
  • Change log
  • Related content

FROST SensorThings API data source for Grafana

Build Release Marketplace Downloads License

A data source plugin for loading OGC SensorThings API data into Grafana.

NO2 Values in Karlsruhe

Using the Plugin

  1. Click the Gear icon in Grafana to enter the configuration menu, select Plugins, and add FROST SensorThings Plugin
  2. Go back and select Data Sources. Click Add data source, choose FROST SensorThings API Plugin
  3. Enter a name for the datasource, and enter the base URL to a SensorThings API server, e.g. https://airquality-frost.k8s.ilt-dmz.iosb.fraunhofer.de/v1.1/
  4. Add authentication settings if needed and click "Save & Test".
  5. Create a new dashboard, under Dashboards, Browse, New Dashboard.
  6. Add a panel (bar icon with plus on the top right)
  7. Make sure the correct datasource is chosen.
  8. Choose Advanced mode and select the desired cache time. Add your path to the Observations you want to visualize (without the baseURL, but keeping the leading /) e.g. /Datastreams(1)/Observations. It is recommended to order the Observations by phenomenonTime (?$orderby=phenomenonTime).

Further Documentation

Full documentation for the plugin is available on website. The developer documentation can be found on GitHub.

Contributions

This plugin is based on the JSON API data source for Grafana by Marcus Olsson. It is the successor of the initial Grafana SensorThings Datasource Plugin by LinkSmart.

Installing FROST SensorThings API Plugin 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 FROST SensorThings API Plugin 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.

Changelog

Version 0.0.5

  • Fixed bug when Manually Assign Fields is empty
  • Added default mapping for fields
  • Updated dependencies

Version 0.0.4

  • Simplified configuration while selecting Datastream
  • Updated dependencies

Version 0.0.3

  • Updated dependencies
  • Added Signing Plugin for release

Version 0.0.2

  • Updated dependencies
  • Build Plugin for submission

Version 0.0.1

First version of rewritten plugin