Document history for the Amazon IoT SiteWise User Guide - 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).

Document history for the Amazon IoT SiteWise User Guide

The following table describes the documentation for this release of Amazon IoT SiteWise.

  • API version: 2019-12-02

ChangeDescriptionDate

Connect external applications to the EMQX broker with usernames and passwords

Added support for connecting external applications using usernames and passwords to the Amazon IoT Greengrass EMQX broker that is deployed by default when creating a new MQTT-enabled, V3 gateway.

May 1, 2025

Support for MQTT-enabled, V3 gateways on SiteWise Edge

Added new features and removed deprecated content

  • Added support for MQTT-enabled, V3 gateways. Enhanced destination configuration using path filters to subscribe to MQTT topics, including real-time data ingestion directly to Amazon IoT SiteWise or buffered data ingestion using Amazon S3.

  • Released version 3.0.0 of the IoT SiteWise OPC UA collector and version 4.0.0 of the IoT SiteWise publisher component for Amazon IoT Greengrass V2.

  • Renamed the previous version of self-hosted SiteWise Edge gateways to Classic streams, V2 gateways.

  • Removed references to Amazon IoT Greengrass V1 in SiteWise Edge documentation because it's no longer supported for use with Amazon IoT SiteWise.

February 26, 2025

Support for Amazon IoT SiteWise Assistant

Added support for the Amazon IoT SiteWise Assistant - a generative AI-powered assistant.

November 18, 2024

Added configurable session timeouts for SiteWise Edge APIs

Added configurable session timeout settings to manage inactivity periods for Amazon OpsHub and SiteWise Edge APIs.

October 31, 2024

Added configurable proxy settings for SiteWise Edge APIs

Added managing trust store information to enable HTTPS proxy support for SiteWise Edge gateways.

October 31, 2024

Enable CORS on for SiteWise Edge APIs

Added CORS support for SiteWise Edge APIs to enable secure cross-domain web application access.

September 30, 2024

Support for CloudRail and Litmus Edge partner data sources

Added support for both CloudRail and Litmus Edge as partner data sources.

September 5, 2024

General availability for running SiteWise Edge on Siemens Industrial Edge

Amazon IoT SiteWise now supports general availability of running SiteWise Edge on Siemens Industrial Edge devices.

July 24, 2024

Added support for timestamp configuration on OPC UA data sources

Amazon IoT SiteWise now supports timestamp configuration for OPC UA data sources.

July 24, 2024

Added support for data type conversion on OPC UA data sources

Amazon IoT SiteWise now supports data type conversion for unsupported OPC UA data types.

July 24, 2024

Added support for running a preview of SiteWise Edge on Siemens Industrial Edge

Amazon IoT SiteWise now supports running a preview of SiteWise Edge on Siemens Industrial Edge devices.

November 26, 2023

Added support for warm tier storage

Amazon IoT SiteWise now supports warm storage, a fully-managed storage tier that makes it easy for customers to securely store and access industrial data.

November 15, 2023

Added support for user-defined unique identifiers

Amazon IoT SiteWise now supports the use of user-defined unique identifiers for asset, asset models, properties and hierarchies.

November 15, 2023

Added support for multi variate anomaly detection of industrial assets

Amazon IoT SiteWise now supports multi variate anomaly detection of industrial assets by integration of historical and real time equipment data with Amazon Lookout for Equipment.

November 15, 2023

Added support for cost-efficient and scalable ingestion of time-series data in Amazon IoT SiteWise

Amazon IoT SiteWise now supports cost-efficient and scalable ingestion of time-series data needed for analytical use cases.

November 15, 2023

Added support for bulk import, export, and update

Amazon IoT SiteWise now supports bulk import, export, and update industrial equipment metadata.

November 15, 2023

Added support for asset model components

Amazon IoT SiteWise now supports Asset model components to help industrial customers create reusable components.

November 15, 2023

Added support for IoT dashboard application

Amazon IoT SiteWise now supports an open source dashboard application where you can visualize and interact with operational data.

November 15, 2023

Updated the service-linked roles for Amazon IoT SiteWise

Amazon IoT SiteWise has new service-linked roles, and can run a metadata search query, against the Amazon IoT TwinMaker database.

November 6, 2023

Updated tagging for Amazon IoT SiteWise data stream resources

Added support for tagging data stream resources.

August 18, 2022

Updated SiteWise Edge gateways

You can now configure the publisher to control what data is sent from the edge to the cloud and the order that it's sent to the cloud.

January 12, 2022

Updated the Amazon IoT SiteWise demo

You can now use the demo to create a SiteWise Monitor portal.

January 10, 2022

Updated storage management

You can now define a retention period to control how long your data is kept in the hot tier.

November 29, 2021

Added support for data stream management

You can now ingest data to Amazon IoT SiteWise before you create asset models and assets.

November 24, 2021

Region launch

Launched Amazon IoT SiteWise in Amazon GovCloud (US-West).

September 29, 2021

Custom metric time interval

Added support for custom time intervals and offsets in metrics.

August 3, 2021

Using Amazon IoT SiteWise at the edge

The edge processing feature is now generally available.

July 29, 2021

Exporting data to Amazon S3

Amazon IoT SiteWise now can export data to Amazon S3.

July 27, 2021

VPC endpoints (Amazon PrivateLink)

The interface VPC endpoint for the control plane API operations is now generally available.

July 15, 2021

Transforms

Transforms now can input multiple asset property variables.

July 8, 2021

Updated the timestamp() function

In transforms, you can now provide a variable as an argument to the timestamp() function.

June 16, 2021

Alarms general availability

The alarms feature is now generally available.

May 27, 2021

Modbus-TCP Protocol Adapter version 2 released

Version 2 of the Modbus-TCP Protocol Adapter connector is available. This release added support for ASCII, UTF8, and ISO8859 encoded source strings.

May 24, 2021

Updated service quotas

Added the following quotas for the GetInterpolatedAssetPropertyValues API: rate of GetInterpolatedAssetPropertyValues requests, number of results per GetInterpolatedAssetPropertyValues request, and number of days between the start date in the past and today for GetInterpolatedAssetPropertyValues.

April 29, 2021

Updated formula expressions

Added the following operators and functions:

April 22, 2021

VPC endpoints (Amazon PrivateLink)

Added information about how to establish a private connection between your virtual private cloud (VPC) and the Amazon IoT SiteWise control plane APIs by creating an interface VPC endpoint.

March 16, 2021

IAM federation

Your SiteWise Monitor portal administrators and users can now log in to their assigned portals with their IAM credentials.

March 16, 2021

Region launch

Launched Amazon IoT SiteWise in China (Beijing).

February 3, 2021

IoT SiteWise connector version 10 released

Version 10 of the IoT SiteWise connector is available. This release configures StreamManager to improve handling when the source connection is lost and re-established. This version also accepts OPC UA values with a ServerTimestamp when no SourceTimestamp is available.

January 22, 2021

Date and time functions

Amazon IoT SiteWise now supports date and time functions.

January 21, 2021

Function syntax

You can now use Uniform Function Call Syntax (UFCS) for Amazon IoT SiteWise functions.

January 11, 2021

Integrating with Grafana

Added information about how to visualize Amazon IoT SiteWise data in Grafana dashboards.

December 15, 2020

Amazon IoT SiteWise now supports customer managed CMKs.

Amazon IoT SiteWise now supports encryption with customer managed CMKs.

November 24, 2020

IoT SiteWise connector version 8 released

Version 8 of the IoT SiteWise connector is available. This release improves stability when the connector experiences intermittent network connectivity.

November 19, 2020

Using strings and conditionals in formula expressions

Added information about how to strings and conditional functions in formula expressions for transforms and metrics.

November 16, 2020

Ingesting data using Amazon IoT Greengrass stream manager

Added information about how to ingest high-volume IoT data from local data sources using an Amazon IoT Greengrass edge device.

September 16, 2020

VPC endpoints (Amazon PrivateLink)

Added information about how to establish a private connection between your virtual private cloud (VPC) and the Amazon IoT SiteWise data APIs by creating an interface VPC endpoint.

September 4, 2020

IoT SiteWise connector version 7 released

Version 7 of the IoT SiteWise connector is available. This release fixes an issue with SiteWise Edge gateway metrics.

August 14, 2020

Creating IAM Identity Center users from the Amazon IoT SiteWise console

Added information about how you can create IAM Identity Center users in the Amazon IoT SiteWise console. You can now create IAM Identity Center users when you assign users to a new or existing portal. Updated the Visualizing and sharing wind farm data tutorial to use this feature. This change reduces the number of steps in the tutorial.

August 4, 2020

Improved SiteWise Edge gateway troubleshooting

Added additional information about how to troubleshoot a SiteWise Edge gateway and how to export the OPC UA client certificate for a source.

June 18, 2020

Console task documentation

Added console task documentation for Modeling industrial assets, Querying asset property data, and Interacting with other services. You can follow these instructions to complete tasks in the Amazon IoT SiteWise console.

June 11, 2020

Analyzing exported data tutorial

Added a tutorial that you can follow to learn how to use Amazon Athena to analyze asset data that you exported to Amazon S3 with the export feature Amazon CloudFormation template.

May 27, 2020

Improved using formula expressions

Added detailed information about the behavior of Amazon IoT SiteWise formula properties and added an example of how to count filtered data points.

May 18, 2020

IoT SiteWise connector version 6 released

Version 6 of the IoT SiteWise connector is available. This release adds support for CloudWatch metrics and automatic discovery of new OPC UA tags. This means you don't need to restart your SiteWise Edge gateway when tags change for your OPC UA sources. This version of the connector requires stream manager and Amazon IoT Greengrass Core software v1.10.0 or higher.

April 29, 2020

Amazon IoT SiteWise feature release

Amazon IoT SiteWise feature release. You can now manage SiteWise Edge gateways with the API, add your logo to portals, view SiteWise Edge gateway metrics, and more.

  • Added the Exporting data to Amazon S3 section with an Amazon CloudFormation template that you can use to export new data values to an Amazon S3 bucket.

  • Added the SiteWise Edge gateway metrics section that describes the CloudWatch metrics that SiteWise Edge gateways publish.

  • Added the Configuring an SiteWise Edge gateway on Amazon EC2 section with an Amazon CloudFormation template that you can use to quickly configure SiteWise Edge gateway dependencies on an Amazon EC2 instance.

  • Added the portal service roles section that describes the new permissions feature of SiteWise Monitor portals.

  • Updated portal documentation for portal service roles and portal logos.

  • Added the Tagging your Amazon IoT SiteWise resources section.

  • Updated the Creating dashboards (CLI) section for the new dashboard definition structure.

  • Added the Security section.

April 29, 2020

Ingesting data from Amazon IoT Events

Added information about how to ingest data from Amazon IoT Events when an event occurs.

April 20, 2020

Visualizing and sharing wind farm data in SiteWise Monitor tutorial

Added a tutorial that you can follow to learn how to use Amazon IoT SiteWise Monitor to visualize and share asset data.

March 12, 2020

Amazon IoT SiteWise concepts

Added a glossary of Amazon IoT SiteWise concepts that you can use to learn about the service and its common terms.

March 5, 2020

Removed Amazon IoT Greengrass installation instructions

Removed the Amazon IoT Greengrass Core software installation instructions from the Amazon IoT SiteWise User Guide. The Amazon IoT Greengrass Developer Guide offers a device setup script and instructions to set up Amazon IoT Greengrass on other platforms such as Amazon EC2 and Docker.

February 14, 2020

Improved ingesting data using Amazon IoT Core rules

Added detailed information about how to use and how to troubleshoot the Amazon IoT SiteWise rule action, which you can use to ingest data from MQTT messages through Amazon IoT Core.

February 14, 2020

IoT SiteWise connector version 5 released

Version 5 of the IoT SiteWise connector is available. This release fixes a compatibility issue with Amazon IoT Greengrass Core software v1.9.4.

February 12, 2020

IoT SiteWise connector version 4 released

Version 4 of the IoT SiteWise connector is available. This release fixes an issue with OPC UA server reconnection.

February 7, 2020

Restructured modeling industrial assets

Restructured the Updating Assets and Models section into multiple topics within Modeling Industrial Assets.

February 4, 2020

Ingesting data from Amazon IoT things tutorial

Added a tutorial that you can follow to learn how to configure an Amazon IoT SiteWise rule action to ingest data from a new or existing fleet of Amazon IoT things.

February 4, 2020

Restructured retrieving data from Amazon IoT SiteWise

Restructured the Retrieving Data section into two top-level sections: Querying asset property values and aggregates and Interacting with other Amazon services.

January 21, 2020

Publishing property value updates to Amazon DynamoDB tutorial

Added a tutorial that you can follow to learn how to use property value notifications to store asset data in DynamoDB.

January 8, 2020

Using formula expressions

Added the formula expression reference to organize the constants and functions available for use in transform and metric properties. Restructured Asset properties into separate topics for each property type.

January 7, 2020

Using OPC UA node filters

Added information about how to use OPC UA node filters to improve SiteWise Edge gateway performance when adding SiteWise Edge gateway sources.

January 3, 2020

Upgrading a connector

Added information about how to upgrade a SiteWise Edge gateway when a new connector version is released.

December 30, 2019

IoT SiteWise connector version 3 released

Version 3 of the IoT SiteWise connector is available. This release removes the iot:* permissions requirement.

December 17, 2019

IoT SiteWise connector version 2 released

Version 2 of the IoT SiteWise connector is available. This release adds support for multiple OPC UA secret resources.

December 10, 2019

Creating dashboards (Amazon CLI)

Added information about how to create a dashboard in Amazon IoT SiteWise Monitor using the Amazon CLI.

December 6, 2019

Amazon IoT SiteWise version 2 released

Released preview for version 2 of Amazon IoT SiteWise. You can now ingest data over OPC UA, MQTT, and HTTP, model your data in asset hierarchies, and visualize your data with SiteWise Monitor.

December 2, 2019

Amazon IoT SiteWise version 1 released

Released initial preview for version 1 of Amazon IoT SiteWise.

February 25, 2019