Skip to content

Well-Architected ​

Run AWS Well-Architected Framework reviews on the account you act as. Define workloads, answer the questions pillar by pillar, and record milestones as you improve. Switch accounts to review another one.

Before you start ​

Well-Architected uses the role from the CloudSmart setup stack. If the account is not connected yet, the page asks you to deploy it. See Get started.

Workloads ​

Workloads lists each workload with its lens count, HIGH, MEDIUM and unanswered risk counts, improvement status and last update.

Choose + New workload and enter:

  • Workload name and description.
  • Environment: Production or Preproduction.
  • Review owner: the person or group responsible for the review.
  • AWS regions: comma-separated, for example us-east-1, eu-west-1.
  • Lenses: one or more lenses to review against.

Select a workload to Review it, Edit lenses or Delete it. Deleting a workload also deletes its review, and you cannot undo it.

Lenses on a workload ​

In Edit lenses, tick the lenses to review the workload against and save. The list covers AWS official lenses, your own lenses and lenses shared with you.

Run a review ​

A review shows the lens's Pillars, each with its risk counts. Select a pillar to see its Questions.

Open a question, tick the choices that apply and choose Save. The risk and the pillar counts update on save. Questions are paged.

Milestones and reports ​

  • New milestone saves a named snapshot of the review. Choose Record milestone to save it.
  • Download report builds the review report. Pick the current state or a milestone, then choose Download PDF.

Custom lenses ​

The Lenses card has three tabs: AWS official, My lenses and Shared with me.

In My lenses:

  • + Create lens: build a lens with your own pillars, questions, choices, improvement plans and risk rules.
  • Publish: publish a draft so it can be used and shared. Each publish makes a new version.
  • Share: share a published lens with other AWS accounts by 12-digit account ID. Results show per account.
  • Shares: see who has the lens and revoke a share.
  • Delete: remove a lens you own.

Lenses shared with you show under Shared with me, in Share invitations. Accept one to use the lens on your workloads, or reject it.

Plans

Well-Architected is on the Standard Edition, Co-Sell Edition, CloudSmart Agent Mode and Onboarding Edition plans. See Plans.