AWSSupport-SendLogBundleToS3Bucket - AWS Systems Manager Automation runbook reference

AWSSupport-SendLogBundleToS3Bucket

Description

The AWSSupport-SendLogBundleToS3Bucket runbook uploads a log bundle generated by the EC2Rescue tool from the target instance to the specified S3 bucket. The runbook installs the platform specific version of EC2Rescue based on the platform of the target instance. EC2Rescue is then used to collect all the available operating system (OS) logs.

Run this Automation (console)

Document type

Automation

Owner

Amazon

Platforms

Linux, macOS, Windows

Parameters

  • AutomationAssumeRole

    Type: String

    Description: (Optional) The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that allows Systems Manager Automation to perform the actions on your behalf. If no role is specified, Systems Manager Automation uses the permissions of the user that starts this runbook.

  • InstanceId

    Type: String

    Description: (Required) The ID of the Windows or Linux managed instance you want to collect logs from.

  • S3BucketName

    Type: String

    Description: (Required) S3 bucket to upload the logs to.

  • S3Path

    Type: String

    Default: AWSSupport-SendLogBundleToS3Bucket/

    Description: (Optional) S3 path for the collected logs.

Required IAM permissions

The AutomationAssumeRole parameter requires the following actions to use the runbook successfully.

It is recommended that the EC2 instance receiving the command has an IAM role with the AmazonSSMManagedInstanceCore Amazon managed policy attached. The user must have at least ssm:StartAutomationExecution and ssm:SendCommand to run the automation and send the command to the instance, plus ssm:GetAutomationExecution to be able to read the automation output.

Document Steps

  1. aws:runCommand - Install EC2Rescue via AWS-ConfigureAWSPackage.

  2. aws:runCommand - Run the PowerShell script to collect Windows troubleshooting logs with EC2Rescue.

  3. aws:runCommand - Run the bash script to collect Linux troubleshooting logs with EC2Rescue.

Outputs

collectAndUploadWindowsLogBundle.Output

collectAndUploadLinuxLogBundle.Output