Troubleshooting

This section provides troubleshooting instructions for deploying and using the solution.

Known issue resolution provides instructions to mitigate known errors. If these instructions don’t address your issue, see the Contact AWS Support section for instructions on opening an AWS Support case for this solution.

Known issue resolution

Failed WorkSpaces

The solution will attempt to modify WorkSpace mode based on the threshold hours. When the solution cannot change the WorkSpace mode due to an exception, such as the workspace being in UNHEALTHY state or booting up during the conversion, the solution will skip this WorkSpace and continue to process other workspaces in the account. The skipped workspaces will be added to the daily report with the message Failed to change mode. You can find more details about the exception in the Amazon ECS logs. The solution will attempt to change the mode again during the next run of the Amazon ECS task.

The solution creates log group and log streams to store logs each run of the Amazon ECS task. To get detailed information on the steps that happened during the solution run, enter the Debug option for the parameter Log Level.

If the you think that the solution did not work as expected or if the report was generated on a certain day, you can find more information about the solution run in the logs for the Amazon ECS task. The easiest way to access the logs is to filter the resources section of the CloudFormation stack by CostOptimizerLogs and select the link for the logs. This will take you to the log group in the CloudWatch service console. From here, you can open the log stream for the day you want to analyze the logs for errors.

If you need more information about a particular WorkSpace, search the logs with the WorkSpace ID of your WorkSpace to see more information filtered down to your WorkSpace.

FAQs

Q: Where is the report that was generated for the WorkSpaces?

A: The solution uploads the report to an Amazon S3 bucket created by the solution. To access the bucket, filter the Resources section of the CloudFormation stack with CostOptimizerBucket. Navigate to the bucket by selecting the link. The reports are uploaded daily.

Q: How to find the Amazon ECS logs?

A: Filter the Resources section of the CloudFormation stack with CostOptimizerLogs

Q: How do I comfirm that a WorkSpace was terminated?

A: The report generated by the solution will have Yes in the Terminated Workspaces column.

Redeploying after deletion

If you delete the hub stack and wish to redeploy it, you must also redeploy all of the spoke stacks; redeploying the hub stack will not automatically work with the existing old spoke templates.