Plugins 〉AWS IoT SiteWise

Data Source
grafana

AWS IoT SiteWise

  • Overview
  • Installation
  • Change log
  • Related content

AWS IoT SiteWise Datasource

This datasource supports reading data from AWS IoT SiteWise and showing it in a Grafana dashboard.

Add the data source

  1. In the side menu under the Configuration link, click on Data Sources.
  2. Click the Add data source button.
  3. Select IoT sitewise in the Industrial & IoT section.

Authentication

The IoT SiteWise plugin authentication matches the standard Cloudwatch plugin system. See the grafana cloudwatch documentation for authentication options and setup.

Once authentication is configured, click "Save and Test" to verify the service is working. Once this is configured, you can specify default values for the configuration.

Query editor

Use the "query type" selector to pick an appropriate query. query-editor

Click on the "Explore" button to open an asset/model navigation interface: query-editor

Multiple aggregations can be showin for a single property: query-editor

Alerting

Standard grafana alertings is support with this plugin, however note that alert queries may not include template variables. See the Alerting documentation for more on Grafana alerts.

Configure the data source with provisioning

You can configure data sources using config files with Grafana's provisioning system. You can read more about how it works and all the settings you can set for data sources on the provisioning docs page.

Here are some provisioning examples for this data source.

Using a credentials file

If you are using Credentials file authentication type, then you should use a credentials file with a config like this.

apiVersion: 1

datasources:

  • name: IoT Sitewise type: datasource jsonData: authType: credentials defaultRegion: us-east-1

Using accessKey and secretKey

apiVersion: 1

datasources:

  • name: IoT Sitewise type: datasource jsonData: authType: keys defaultRegion: us-east-1 secureJsonData: accessKey: ‘<your access key>’ secretKey: ‘<your secret key>’

For more information, visit the docs on plugin installation.

Change Log

All notable changes to this project will be documented in this file.

v1.2.4

  • Add linux/LDAP based authentication for Edge region.

v1.2.3

  • Update AUTO aggregation to better select the resolution, and switch to the raw asset property value data when higher than 1m resolution is needed.

v1.2.2

  • Adds resource cache for describe calls in the plugin back-end

v1.2.1

  • Updates shared aws configuration library
  • Bumps min version to 7.5

v1.2.0

  • Shares auth confiuration with cloudwatch
  • Bumps min version to 7.4

v1.1.0

  • Allowing 'Edge' region
  • Support nil values in response #82
  • Update aws libraries

v1.0.0

  • Initial Release