IoT SiteWise publisher - Amazon IoT Greengrass
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).

IoT SiteWise publisher

The IoT SiteWise publisher component (aws.iot.SiteWiseEdgePublisher) enables Amazon IoT SiteWise gateways to export data from the edge to the Amazon Web Services Cloud.

For more information about Amazon IoT SiteWise gateways, see Using Amazon IoT SiteWise at the edge in the Amazon IoT SiteWise User Guide.

Versions

This component has the following versions:

  • 2.3.x

  • 2.2.x

  • 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 core devices that run the following operating systems:

  • Linux

  • Windows

Requirements

This component has the following requirements:

  • The Greengrass core device must run on one of the following platforms:

    • OS: Ubuntu 18.04 or later

      Architecture: x86_64 (AMD64) or ARMv8 (Aarch64)

    • OS: Red Hat Enterprise Linux (RHEL) 8

      Architecture: x86_64 (AMD64) or ARMv8 (Aarch64)

    • OS: Amazon Linux 2

      Architecture: x86_64 (AMD64) or ARMv8 (Aarch64)

    • OS: Debian 11

      Architecture: x86_64 (AMD64) or ARMv8 (Aarch64)

    • OS: Windows Server 2019 or later

      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 Amazon 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

data.iotsitewise.region.amazonaws.com

443 Yes

Publish data to Amazon IoT SiteWise.

Dependencies

When you deploy a component, Amazon 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 Amazon IoT Greengrass console. On the component details page, look for the Dependencies list.

The following table lists the dependencies for versions 2.0.x to 2.2.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 Amazon IoT SiteWise console or API to configure the IoT SiteWise publisher component. For more information, see Step 3: Configure publisher - optional in the Amazon IoT SiteWise User Guide.

Input data

This component reads BatchPutAssetPropertyValue messages from Amazon IoT Greengrass stream manager. For more information, see BatchPutAssetPropertyValue in the Amazon IoT SiteWise API Reference.

Local log file

This component uses the following log file.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\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 or C:\greengrass\v2 with the path to the Amazon IoT Greengrass root folder.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait

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.3.1

New features
  • Adds support for installing Data Collection Pack on Linux ARMv8 architecture.

  • Minimum requirements for Linux ARMv8:

    • Memory: 4 GB

    • CPU: ARM Cortex-A72 or equivalent specification

2.2.3

Bug fixes and improvements
  • Removes retry for generic exception which was not in the retriable exception list.

2.2.2

Bug fixes and improvements
  • Reintroduces data upload support to Amazon IoT SiteWise through an HTTP proxy server.

2.2.1

Note

This version doesn't support HTTP proxy configuration. Version 2.2.2 and higher reintroduces support for this feature.

New features
  • Adds support to this component to toggle compression when uploading data to Amazon IoT SiteWise.

2.2.0

Note

This version doesn't support HTTP proxy configuration. Version 2.2.2 and higher reintroduces support for this feature.

New features
  • Updates this component to compress data before sending it to the Amazon IoT SiteWise service.

    • In most cases, this change reduces bandwidth usage by 75 percent compared to previous versions of this component.

    • In most cases, this change increases CPU usage by up to 5 percent. On gateways that process large amounts of data, this change can increase CPU usage by up to 15 percent.

    • This change doesn't affect Amazon IoT SiteWise service charges or service quota usage.

    • Adds support for Windows Server 2019 or higher.

Bug fixes and improvements
  • Fixes an issue that prevents this component from starting when the checkpoint file is corrupted.

2.1.4

Bug fixes and improvements
  • Fixes compatibility with Java version 8.

2.1.3

Warning

This version is no longer available, except in the US East (Ohio), Canada (Central), and Amazon 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.

Bug fixes and improvements
  • Improves error messages when you deploy this component on unsupported devices.

  • Updates to log errors when data uploads fail.

2.1.2

Bug fixes and improvements
  • Updates to invoke the expired data export feature as soon as data expires.

2.1.1

Bug fixes and improvements.

2.1.0

New features
  • Adds support for publishing the newest data to the cloud first.

  • Adds support for not publishing expired data to the cloud.

  • Adds support for storing expired data locally.

Bug fixes and improvements
  • Reduces disk I/O and corresponding latency.

2.0.2

Bug fixes and improvements.

2.0.1

Initial version.

See also