AWS-provided components - AWS IoT Greengrass

AWS-provided components

AWS IoT Greengrass provides and maintains prebuilt components that you can deploy to your devices. These components include features (such as stream manager), AWS IoT Greengrass V1 connectors (such as CloudWatch metrics), and local development tools (such as the AWS IoT Greengrass CLI). You can deploy these components to your devices for their standalone functionality, or you can use them as dependencies in your custom Greengrass components.

Note

Several AWS-provided components depend on specific minor versions of the Greengrass nucleus. Because of this dependency, you need to update these components when you update the Greengrass nucleus to a new minor version. For information about the specific versions of the nucleus that each component depends on, see the corresponding component topic. For more information about updating the nucleus, see Update the AWS IoT Greengrass Core software (OTA).

When a component has a component type of both generic and Lambda, the current version of the component is the generic type and a previous version of the component is the Lambda type.

Component Description Component type Supported OS Open source
Greengrass nucleus The nucleus of the AWS IoT Greengrass Core software. Use this component to configure and update the software on your core devices. Nucleus Linux, Windows Yes
Client device auth Enables local IoT devices, called client devices, to connect to the core device. Plugin Linux, Windows Yes
CloudWatch metrics Publishes custom metrics to Amazon CloudWatch. Generic, Lambda Linux, Windows Yes
AWS IoT Device Defender Notifies administrators of changes in the state of the Greengrass core device to identify unusual behavior. Generic, Lambda Linux, Windows Yes
Disk spooler Enables a persistent storage option for messages spooled from Greengrass core devices to AWS IoT Core. This component will store these outbound messages on disk. Plugin Linux, Windows Yes
Docker application manager Enables AWS IoT Greengrass to download Docker images from Docker Hub and Amazon Elastic Container Registry (Amazon ECR). Generic Linux, Windows No
Edge connector for Kinesis Video Streams Reads video feeds from local cameras, publishes the streams to Kinesis Video Streams, and displays the streams in Grafana dashboards with AWS IoT TwinMaker. Generic Linux No
Greengrass CLI Provides a command-line interface that you can use to create local deployments and interact with the Greengrass core device and its components. Plugin Linux, Windows Yes
IP detector Reports MQTT broker connectivity information to AWS IoT Greengrass, so client devices can discover how to connect. Plugin Linux, Windows Yes
Firehose Publishes data through Amazon Data Firehose delivery streams to destinations in the AWS Cloud. Lambda Linux No
Lambda launcher Handles processes and environment configuration for Lambda functions. Generic Linux No
Lambda manager Handles interprocess communication and scaling for Lambda functions. Plugin Linux No
Lambda runtimes Provides artifacts for each Lambda runtime. Generic Linux No
Legacy subscription router Manages subscriptions for Lambda functions that run on AWS IoT Greengrass V1. Generic Linux No
Local debug console Provides a local console that you can use to debug and manage the Greengrass core device and its components. Plugin Linux, Windows Yes
Log manager Collects and uploads logs on the Greengrass core device. Plugin Linux, Windows Yes
Machine learning components Provides machine learning models and sample inference code that you can use to perform machine learning inference on Greengrass core devices. See Machine learning components.
Modbus-RTU protocol adapter Polls information from local Modbus RTU devices. Lambda Linux No
Nucleus telemetry emitter Publishes system health telemetry data gathered from the nucleus to a local topic or to an AWS IoT Core MQTT topic. Plugin Linux, Windows Yes
MQTT bridge Relays MQTT messages between client devices, local AWS IoT Greengrass publish/subscribe, and AWS IoT Core. Plugin Linux, Windows Yes
MQTT 3.1.1 broker (Moquette) Runs an MQTT 3.1.1 broker that handles messages between client devices and the core device. Plugin Linux, Windows Yes
MQTT 5 broker (EMQX) Runs an MQTT 5 broker that handles messages between client devices and the core device. Generic Linux, Windows No
PKCS#11 provider Enables Greengrass components to to access a private key and certificate that you securely store in a hardware security module (HSM). Plugin Linux Yes
Secret manager Deploys secrets from AWS Secrets Manager secrets so that you can securely use credentials, such as passwords, in custom components on the Greengrass core device. Plugin Linux, Windows Yes
Secure tunneling Enables AWS IoT secure tunneling connections that you can use to establish bidrectional communications with Greengrass core devices that are behind restricted firewalls. Generic Linux No
Shadow manager Enables interaction with shadows on the core device. It manages shadow document storage and also the synchronization of local shadow states with the AWS IoT Device Shadow service. Plugin Linux, Windows Yes
Amazon SNS Publishes messages to Amazon SNS topics. Lambda Linux No
Stream manager Streams high-volume data from local sources to the AWS Cloud. Generic Linux, Windows No
Systems Manager Agent Manage the core device with AWS Systems Manager, which enables you to patch devices, run commands, and more. Generic Linux No
Token exchange service Provides AWS credentials that you can use to interact with AWS services. Generic Linux, Windows No
IoT SiteWise OPC-UA collector Collects data from OPC-UA servers. Generic Linux, Windows No
IoT SiteWise OPC-UA data source simulator Runs a local OPC-UA server that generates sample data. Generic Linux, Windows No
IoT SiteWise publisher Publishes data to the AWS Cloud. Generic Linux, Windows No
IoT SiteWise processor Processes data on the Greengrass core devices. Generic Linux, Windows No