Logging and monitoring in Amazon IoT Greengrass - 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).

Amazon IoT Greengrass Version 1 entered the extended life phase on June 30, 2023. For more information, see the Amazon IoT Greengrass V1 maintenance policy. After this date, Amazon IoT Greengrass V1 won't release updates that provide features, enhancements, bug fixes, or security patches. Devices that run on Amazon IoT Greengrass V1 won't be disrupted and will continue to operate and to connect to the cloud. We strongly recommend that you migrate to Amazon IoT Greengrass Version 2, which adds significant new features and support for additional platforms.

Logging and monitoring in Amazon IoT Greengrass

Monitoring is an important part of maintaining the reliability, availability, and performance of Amazon IoT Greengrass and your Amazon solutions. You should collect monitoring data from all parts of your Amazon solution so that you can more easily debug a multi-point failure, if one occurs. Before you start monitoring Amazon IoT Greengrass, you should create a monitoring plan that includes answers to the following questions:

  • What are your monitoring goals?

  • Which resources will you monitor?

  • How often will you monitor these resources?

  • Which monitoring tools will you use?

  • Who will perform the monitoring tasks?

  • Who should be notified when something goes wrong?

Monitoring tools

Amazon provides tools that you can use to monitor Amazon IoT Greengrass. You can configure some of these tools to do the monitoring for you. Some of the tools require manual intervention. We recommend that you automate monitoring tasks as much as possible.

You can use the following automated monitoring tools to monitor Amazon IoT Greengrass and report issues:

  • Amazon CloudWatch Logs – Monitor, store, and access your log files from Amazon CloudTrail or other sources. For more information, see Monitoring log files in the Amazon CloudWatch User Guide.

  • Amazon CloudTrail Log Monitoring – Share log files between accounts, monitor CloudTrail log files in real time by sending them to CloudWatch Logs, write log processing applications in Java, and validate that your log files have not changed after delivery by CloudTrail. For more information, see Working with CloudTrail log files in the Amazon CloudTrail User Guide.

  • Amazon EventBridge – Use EventBridge event rules to get notifications about state changes for your Greengrass group deployments or API calls logged with CloudTrail. For more information, see Get deployment notifications or What is Amazon EventBridge? in the Amazon EventBridge User Guide.

  • Greengrass system health telemetry – Subscribe to receive telemetry data sent from the Greengrass core. For more information, see Gathering system health telemetry data from Amazon IoT Greengrass core devices.

  • Local health check – Use the health APIs to get a snapshot of the state of local Amazon IoT Greengrass processes on the core device. For more information, see Calling the local health check API.

See also