IoT SiteWise publisher
The IoT SiteWise publisher component (aws.iot.SiteWiseEdgePublisher
) enables AWS IoT SiteWise gateways to
export data from the edge to the AWS Cloud.
For more information about AWS IoT SiteWise gateways, see Using AWS IoT SiteWise at the edge in the AWS IoT SiteWise User Guide.
Topics
Versions
This component has the following versions:
-
2.1.x
-
2.0.x
Type
This component is a generic component
(aws.greengrass.generic
). The Greengrass
nucleus runs the component's lifecycle scripts.
For more information, see Component types.
Operating system
This component can be installed on Linux core devices only.
Requirements
This component has the following requirements:
-
The Greengrass core device must run on one of the following platforms:
-
OS: Ubuntu 20.04 or 18.04
Architecture: x86_64 (AMD64)
-
OS: Red Hat Enterprise Linux (RHEL) 8
Architecture: x86_64 (AMD64)
-
OS: Amazon Linux 2
Architecture: x86_64 (AMD64)
-
-
The Greengrass core device must connect to the Internet.
-
The Greengrass core device must be authorized to perform the
iotsitewise:BatchPutAssetPropertyValue
action. For more information, see Authorize core devices to interact with AWS services.Example permissions policy
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*" } ] }
Endpoints and ports
This component must be able to perform outbound requests to the following endpoints and ports, in addition to endpoints and ports required for basic operation. For more information, see Allow device traffic through a proxy or firewall.
Endpoint | Port | Required | Description |
---|---|---|---|
|
443 | Yes |
Publish data to AWS IoT SiteWise. |
Dependencies
When you deploy a component, AWS IoT Greengrass also deploys compatible versions of its dependencies. This means that you must meet the requirements for the component and all of its dependencies to successfully deploy the component. This section lists the dependencies for the released versions of this component and the semantic version constraints that define the component versions for each dependency. You can also view the dependencies for each version of the component in the AWS IoT Greengrass console
The following table lists the dependencies for versions 2.0.x to 2.1.x of this component.
Dependency | Compatible versions | Dependency type |
---|---|---|
Greengrass nucleus | >=2.3.0<3.0.0 | Hard |
Stream manager | >=2.0.10<3.0.0 | Hard |
For more information about component dependencies, see the component recipe reference.
Configuration
This component doesn't have any configuration parameters.
You can use the AWS IoT SiteWise console or API to configure the IoT SiteWise publisher component. For more information, see Step 3: Configure publisher - optional in the AWS IoT SiteWise User Guide.
Input data
This component reads BatchPutAssetPropertyValue
messages from AWS IoT Greengrass stream
manager. For more information, see BatchPutAssetPropertyValue in the AWS IoT SiteWise API Reference.
Local log file
This component uses the following log file.
/greengrass/v2
/logs/aws.iot.SiteWiseEdgePublisher.log
To view this component's logs
-
Run the following command on the core device to view this component's log file in real time. Replace
/greengrass/v2
with the path to the AWS IoT Greengrass root folder.sudo tail -f
/greengrass/v2
/logs/aws.iot.SiteWiseEdgePublisher.log
Licenses
This component is released under the Greengrass Core Software License Agreement
Changelog
The following table describes the changes in each version of the component.
Version |
Changes |
---|---|
2.1.4 |
|
2.1.3 |
This version is no longer available, except in the US East (Ohio), Canada (Central), and AWS GovCloud (US-East) Regions. This component version requires Java version 11 or greater to run. The improvements in this version are available in later versions of this component.
|
2.1.2 |
|
2.1.1 |
Bug fixes and improvements. |
2.1.0 |
|
2.0.2 |
Bug fixes and improvements. |
2.0.1 |
Initial version. |
See also
-
What is AWS IoT SiteWise? in the AWS IoT SiteWise User Guide.