Configure edge data processing for Amazon IoT SiteWise models and assets - Amazon IoT SiteWise
Process data at the edge
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Configure edge data processing for Amazon IoT SiteWise models and assets

You can use Amazon IoT SiteWise Edge to collect, store, organize and monitor equipment data locally. You can use SiteWise Edge so that you can model your industrial data and SiteWise Monitor to create dashboards for your operational staff to visualize data locally. You can process your data locally and send it to the Amazon Cloud, or process it on-premises by using the Amazon IoT SiteWise API.

With Amazon IoT SiteWise Edge, you can process raw data locally and choose to send only aggregated data to the Amazon Cloud to optimize your bandwidth usage and cloud storage costs.

Note

  • Amazon IoT SiteWise retains your edge data on your SiteWise Edge gateways up to 30 days. The retention period of your data is dependent on the available disk space of your device.

  • If your SiteWise Edge gateway has been disconnected from the Amazon Cloud for 30 days, the Set up an OPC UA source in SiteWise Edge is automatically disabled.

Configure an asset model for data processing on SiteWise Edge

Asset properties include metrics, transforms, and measurements:

  • Metrics are the asset's aggregated data over a specified period of time. You can compute new metrics by using existing metric data. Amazon IoT SiteWise always sends your metrics to the Amazon Cloud for long-term storage. Amazon IoT SiteWise computes metrics on the Amazon Cloud by default. You can configure your asset model to compute your metrics at the edge. Amazon IoT SiteWise sends processed results to the Amazon Cloud.

  • Transforms are mathematical expressions that map an asset property's data points from one form to another. Transforms can use metrics as input data and must be computed and stored at the same location as their inputs. If you configure a metric input to compute at the edge, Amazon IoT SiteWise also computes its associated transform at the edge.

  • Measurements are formatted as raw data that your device collects and sends to the Amazon Cloud by default. You can configure your asset model to store this data on your local device.

For more information about asset properties, see Define data properties.

After you create your asset model, you can then configure it for the edge. For more information about configuring your asset model for the edge, see Create an asset model (console).

Note

Asset models and dashboards are automatically synced between the Amazon Cloud and your SiteWise Edge gateway every 10 minutes. You can also sync manually from the Manage SiteWise Edge gateways.

You can use the Amazon IoT SiteWise REST APIs and the Amazon Command Line Interface (Amazon CLI) to query your SiteWise Edge gateway for data at the edge. Before you query your SiteWise Edge gateway for data at the edge, you must meet the following prerequisites:

  • Your credentials must be set for the REST APIs. For more information about setting credentials, see Manage SiteWise Edge gateways.

  • The SDK endpoint must point to the IP address of your SiteWise Edge gateway. You can find more information in the documentation for your SDK. For example, see Specifying Custom Endpoints in the Amazon SDK for Java 2.x Developer Guide.

  • Your SiteWise Edge gateway certificate must be registered. You can find more information about registering your SiteWise Edge gateway certificate in the documentation for your SDK. For example, see the Registering Certificate Bundles in Node.js in the Amazon SDK for Java 2.x Developer Guide.

For more information about querying data with Amazon IoT SiteWise, see Query data from Amazon IoT SiteWise.