Processing data at the edge - Amazon IoT SiteWise
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).

Processing data at the edge

You must configure your asset model for the edge before your can process your SiteWise Edge gateway data at the edge. Your asset model edge configuration specifies where your assets properties are computed. You can choose to compute all properties at the edge and send the results to the Amazon Web Services Cloud, or customize where to compute each asset property separately. For more information, see .

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 Defining 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 Creating 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 Managing 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 Managing 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.