Manage data streams for Amazon IoT SiteWise - 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).

Manage data streams for Amazon IoT SiteWise

A data stream is the resource that contains historical time series data. Each data stream is identified by a unique alias, making it easier to keep track of the origin for each piece of data. Data streams are automatically created in Amazon IoT SiteWise when the first time series data is received. If the first time series data is identified with an alias, Amazon IoT SiteWise creates a new data stream with that alias, provided no asset properties are already assigned that alias. Alternatively, if the first time series data is identified with an asset ID and property ID, Amazon IoT SiteWise creates a new data stream and associates that data stream with the asset property.

There are two ways to assign an alias to an asset property. The method used depends on if data is sent to Amazon IoT SiteWise first, or an asset is created first.

  • If data is sent to Amazon IoT SiteWise first, this automatically creates a data stream with the assigned alias. When the asset is created later, use the AssociateTimeSeriesToAssetProperty API to associate the data stream and its alias to the asset property.

  • If an asset is created first, use the UpdateAssetProperty API to assign an alias to an asset property. When data is later sent to Amazon IoT SiteWise, the data stream is automatically created and associated with the asset property.

Currently, you can only associate data streams with measurements. Measurements are a type of asset property that represent devices' raw sensor data streams, such as timestamped temperature values or timestamped rotations per minute (RPM) values.

When these measurements define metrics or transformations, the incoming data triggers specific calculations. It’s important to note that an asset property can only be linked to one data stream at a time.

Amazon IoT SiteWise uses TimeSeries for the Amazon Resource Name (ARN) resource to determine your storage charges. For more information, see Amazon IoT SiteWise Pricing.

The following sections show you how to use the Amazon IoT SiteWise console or API to manage data streams.

Topics