Mapping industrial data streams to asset properties - 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).

Mapping industrial data streams to asset properties

You can define a property alias on asset property. This helps you identify an asset property when you ingest or retrieve asset data. If your asset has measurement properties, you can define the property aliases to map your data streams to those measurement properties.

This process requires that you know your property alias.

  • If you ingest data from OPC-UA servers using an OPC-UA data source in a SiteWise Edge gateway, your property alias is the path to a variable under the Objects node, starting with /.

    Example

    If the path to your variable is company/windfarm/3/turbine/7/temperature, then your property alias is /company/windfarm/3/turbine/7/temperature.

    For more information about OPC-UA information architecture, see Information Model and Address Spacing mapping in the OPC UA Online Reference.

    Notes

    • If you configure a data stream prefix for your OPC-UA source, you must include that prefix in the property alias for all data streams from that source.

      Example

      If /RentonWA is a prefix, then the previous alias is /RentonWA/company/windfarm/3/turbine/7/temperature.

    • Property aliases can contain up to 1,000 bytes. OPC-UA variables paths can contain up to 4,096 bytes. Currently, Amazon IoT SiteWise doesn't support ingesting data from OPC-UA variables with long paths.

  • If you ingest data from Modbus servers using a Modbus TCP data source in a SiteWise Edge gateway, your property alias is:

    Modbus register set tag name

    Use this value to send data from this register set to an asset property.

  • If you ingest data from other sources, such as using Amazon IoT rules or the API, you must define your property aliases. You can define a property alias naming system that is applicable to your device configuration. For example, if you ingest data from Amazon IoT things, you can include the thing name in property aliases to uniquely identify data streams. For more information about this example, see the Ingesting data from Amazon IoT things tutorial.

Property aliases must be unique within a Region and Amazon account. Amazon IoT SiteWise returns an error if you set a property alias to one that already exists on another asset property.

If you have multiple OPC-UA sources with identical data stream paths, add a prefix to each source's paths to form unique aliases. For more information, see Configuring data sources.

Topics