What is Amazon WorkSpaces Advisor?
Amazon WorkSpaces Advisor is an AI-powered feature that helps you identify and resolve issues impacting your WorkSpaces Personal resources. You start an investigation by describing the problem you're experiencing in your own words. WorkSpaces Advisor then reviews telemetry, knowledge bases, and best practices, anchored to your description. It surfaces the most relevant issues, along with recommended remediation actions, directly in the Amazon WorkSpaces console.
With WorkSpaces Advisor, you can:
Describe the issue you're experiencing so Advisor can focus its investigation
Investigate a WorkSpace and receive the issues most relevant to what you described
Review supporting telemetry data, including Amazon CloudWatch metrics, for each issue
Take recommended remediation actions
Chat with WorkSpaces Advisor for follow-up questions through Amazon Q Developer
Create a support case pre-populated with investigation context
WorkSpaces Advisor is available in all AWS Regions that support Amazon WorkSpaces Personal at no additional cost.
Contents
How investigations work
To start an investigation, select a WorkSpace and choose Investigate. On the Investigate with Advisor screen, describe the problem you're experiencing, for example, the symptoms or any error messages observed, so WorkSpaces Advisor can focus its investigation. Do not include personally identifiable or confidential information. When you choose Investigate, WorkSpaces Advisor deploys AI agents to analyze data from the selected WorkSpace. The analysis typically completes in under 60 seconds.
WorkSpaces Advisor returns the issues most relevant to what you reported. For each issue, WorkSpaces Advisor provides at least one recommended action, describes the risk and impact to your resources, and might offer alternative actions.
Describing the issue is optional. If you leave the description blank, WorkSpaces Advisor runs a broad scan of the WorkSpace instead.
If WorkSpaces Advisor cannot identify your issue, it tells you the issue needs a specialist and offers to create an AWS Support case pre-populated with the investigation context. You can also provide feedback through the console.
Investigation limits
You can investigate one WorkSpace at a time.
Data accessed by WorkSpaces Advisor
WorkSpaces Advisor accesses the following data to perform investigations:
Amazon CloudWatch metrics (for example, CPU usage, memory usage, and disk usage)
WorkSpaces resource configuration (WorkSpace ID, VPC, subnet, bundle type)
Service telemetry
Application names running on the WorkSpace, including their CPU and memory usage
AWS documentation and knowledge bases
Investigate a WorkSpace
Open the Amazon WorkSpaces console
. In the navigation pane, choose WorkSpaces, then Personal.
Select the WorkSpace that you want to investigate.
Choose Investigate.
On the Investigate with Advisor screen, describe the issue you're experiencing. Include any symptoms or error messages observed so WorkSpaces Advisor can focus its investigation. Do not include personally identifiable or confidential information. (This step is optional; leave it blank to run a broad scan.)
Choose Investigate to start the investigation.
Review the identified issues, which are focused on what you described. Choose an issue to view details, including supporting telemetry and the recommended action.
Review the risk and impact information for the recommended action, then choose the action to initiate it.
Get additional help with Amazon Q Developer
Chat with WorkSpaces Advisor — Choose Chat with WorkSpaces Advisor on the issue details page to ask follow-up questions through AWS Console chat. The chat session automatically includes the full context of the issue.
Create a support case — Choose Create support case to contact AWS Support. The support case is pre-populated with the investigation context.
In both cases you will need permissions to use Amazon Q Developer in the console. For more information about using Amazon Q Developer, see Chatting with Amazon Q Developer about AWS.
Required permissions
WorkSpaces Advisor uses Forward access sessions (FAS) to perform actions using your IAM identity and permissions.
Permissions for investigations
Your IAM role must have the following permissions for WorkSpaces Advisor to initiate investigations and retrieve
recommendations. These include
workspaces:InvokeTroubleshootingInvestigation,
workspaces:GetTroubleshootingRecommendation, and
workspaces:ListTroubleshootingRecommendations.
Your IAM role must have read permissions for WorkSpaces and Amazon CloudWatch APIs, such as
workspaces:DescribeWorkSpaces and cloudwatch:GetMetricData. If your role is
missing permissions for specific checks, WorkSpaces Advisor skips those checks and
displays a message so you can update your permissions.
Permissions for remediation actions
Your IAM role must have permission to perform the specific action (for example,
workspaces:RebootWorkSpaces or
workspaces:ModifyWorkSpaceProperties). If your role does not have the
required permission, WorkSpaces Advisor returns an error.
Cross-Region Inference
Model inference is the process of a model generating an output (response) from a given input (prompt). To use an optimal model for each feature, WorkSpaces Advisor may use cross-region inference for data processing. This means WorkSpaces Advisor will automatically select the optimal AWS Region to process inference requests. The available AWS Regions vary based on the region of your WorkSpaces resource. All data is transmitted encrypted across Amazon's secure network and does not traverse the public internet.
The following table lists the inference regions that WorkSpaces Advisor may use:
| Amazon WorkSpaces resource Region | Inference Regions |
|---|---|
US East (N. Virginia) (us-east-1) US East (Ohio) (us-east-2) US West (Oregon) (us-west-2) |
US East (N. Virginia) (us-east-1) US East (Ohio) (us-east-2) US West (Oregon) (us-west-2) |
Africa (Cape Town) (af-south-1) |
Africa (Cape Town) (af-south-1) |
Asia Pacific (Malaysia) (ap-southeast-5) |
Asia Pacific (Malaysia) (ap-southeast-5) |
Asia Pacific (Mumbai) (ap-south-1) |
Asia Pacific (Mumbai) (ap-south-1) |
Asia Pacific (Seoul) (ap-northeast-2) |
Asia Pacific (Seoul) (ap-northeast-2) |
Asia Pacific (Singapore) (ap-southeast-1) |
Asia Pacific (Singapore) (ap-southeast-1) |
Asia Pacific (Sydney) (ap-southeast-2) |
Asia Pacific (Sydney) (ap-southeast-2) |
Asia Pacific (Tokyo) (ap-northeast-1) |
Asia Pacific (Tokyo) (ap-northeast-1) |
Canada (Central) (ca-central-1) |
Canada (Central) (ca-central-1) US East (N. Virginia) (us-east-1) US East (Ohio) (us-east-2) US West (Oregon) (us-west-2) |
Europe (Frankfurt) (eu-central-1) Europe (Ireland) (eu-west-1) Europe (Paris) (eu-west-3) |
Europe (Frankfurt) (eu-central-1) Europe (Ireland) (eu-west-1) Europe (Milan) (eu-south-1) Europe (Paris) (eu-west-3) Europe (Spain) (eu-south-2) Europe (Stockholm) (eu-north-1) |
Europe (London) (eu-west-2) |
Europe (London) (eu-west-2) Europe (Frankfurt) (eu-central-1) Europe (Ireland) (eu-west-1) Europe (Milan) (eu-south-1) Europe (Paris) (eu-west-3) Europe (Spain) (eu-south-2) Europe (Stockholm) (eu-north-1) |
Israel (Tel Aviv) (il-central-1) |
Israel (Tel Aviv) (il-central-1) |
South America (Sao Paulo) (sa-east-1) |
South America (Sao Paulo) (sa-east-1) |
Opting out of using your data for service improvement
You can choose to opt out of having your data used to develop and improve WorkSpaces Advisor and its underlying technology by using the AWS Organizations opt-out policy. You can choose to opt out even if WorkSpaces Advisor doesn't currently collect any such data. For more information about how to opt out, see AI services opt-out policies in the AWS Organizations User Guide.
Note
For you to use the opt-out policy, your AWS accounts must be centrally managed by AWS Organizations. If you haven't already created an organization for your AWS accounts, see Creating and managing an organization in the AWS Organizations User Guide.
Opting out has the following effects:
WorkSpaces Advisor will delete the data that it collected and stored for service improvement purposes prior to your opt out (if any).
After you opt out, WorkSpaces Advisor will no longer collect or store this data for service improvement purposes.
