How do I use the AWSSupport-CollectECSInstanceLogs runbook to collect troubleshooting logs of my ECS instances?

2 minute read

I want to use the AWSSupport-CollectECSInstanceLogs runbook to collect all troubleshooting logs for my Amazon Elastic Container Service (Amazon ECS) instance.


Note: Before you run the AWSSupport-CollectECSInstanceLogs automation, make sure that the AWS Identity and Access Management (IAM) entity that you use has the required IAM permissions. See the Required IAM permissions section of AWSSupport-CollectECSInstanceLogs.

To use the runbook, complete the following steps:

  1. Open the AWS Systems Manager console.
  2. In the navigation pane, choose Documents.
  3. In the search bar, enter AWSSupport-CollectECSInstanceLogs.
  4. Select the AWSSupport-CollectECSInstanceLogs runbook. Then, choose Execute automation, or choose Run this Automation (console).
  5. For the input parameters, enter the following information:
    AutomationAssumeRole (optional): The ARN of the role that allows the automation to perform the actions.
    ECSInstanceID (required): The ID of the Amazon ECS instance that you want to collect logs from. AWS Systems Manager must manage the instance. 
    LogDestination (optional): A valid Amazon Simple Storage Service (Amazon S3) bucket to upload the Amazon ECS logs to. If you don't provide this parameter, then the automation runbook doesn't upload.
  6. Choose Execute.
  7. Review the Outputs section for log location information.

Related information

Run an automation

Setting up Automation

Systems Manager Automation runbook reference