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 AWS IoT SiteWise when the first time series data is received. If the first time series data is identified with an alias, AWS 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, AWS 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 AWS IoT SiteWise first, or an asset is created first.
-
If data is sent to AWS 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 AWS 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.
AWS IoT SiteWise uses TimeSeries for the Amazon Resource Name (ARN) resource to
determine your storage charges. For more information, see AWS IoT SiteWise Pricing
The following sections show you how to use the AWS IoT SiteWise console or API to manage data streams.
Topics
