Monitor Maintenance Container

In this guide, you will:

• Use AWS CloudWatch to monitor the maintenance container logs.
• Verify ECS task status and deployments.

Guardrails operates its core services within secure, private ECS clusters that are never exposed to the public internet. These clusters run several container types essential to the platform — API containers handle inbound traffic from the load balancer, events containers process real-time cloud events, and Terraform factory containers dynamically generate templates for short-lived tasks. Regularly monitoring the maintenance container is crucial, as it helps validate the health and functioning of these background services, ensuring that the system remains stable, responsive, and capable of processing workloads effectively.

Prerequisites

• Access to the Guardrails AWS account with Administrator Privileges.
• Familiarity with AWS Console, CloudWatch.

Step 1: Access AWS Console

Open the AWS Console and navigate to the CloudWatch service in the region where Guardrails is deployed.

Step 2: Select Log Group

Choose Log Groups from the left navigation menu.

Step 3: Select Maintenance Log Group

From the list of log groups, choose the maintenance log group, typically named in the format /turbot/<te_version_number>/maintenance.

Note

If multiple TE versions are installed, make sure to select the log group corresponding to the latest installed version.

Choose Search Log Group from the top right.

Step 4: Review Logs for Errors

Check the CloudWatch logs for any errors that may have occurred during the monitoring period. The logs provide visibility into container activity and help identify potential issues.

Note

The maintenance container is expected to run without errors. However, if any errors are observed in the logs, please report them to Guardrails Support for further investigation.

Next Steps

Please see the following resources to learn more about Turbot Guardrails Enterprise:

• Learn how to Diagnose Control Errors.
• Learn how to Investigate an Event Flood.

Troubleshooting