What's new in the Azure Well-Architected Framework

Find out about recent changes in the Azure Well-Architected Framework.

October 2024

Updated articles

  • Architecture decision record (ADR): We refreshed the guidance on what an ADR should include, including consistent elements like problem statements, options considered, and decision outcomes. Explore updates including a new section on suggested characteristics of an individual record with guidelines for maintaining consistent and useful ADRs

  • Azure Well-Architected Framework perspective on Azure Application Gateway v2: We made significant updates to the guidance about Azure Application Gateway v2. Find important notes and links to additional resources for Azure Application Gateway configurations. Explore enhanced content with specific design principles, strategies, and recommendations for achieving architectural goals.

  • Azure Well-Architected Framework perspective on Azure ExpressRoute: We made significant updates to provide more comprehensive and structured guidance on Azure ExpressRoute, enhancing and expanding upon best practices, design principles, and optimization strategies. The detailed checklists and recommendations help in better planning and implementation, ensuring improved reliability, security, and cost efficiency.

We reviewed all tradeoff and design pattern articles for alignment with the content structure and to ensure that the guidance is up to date. Tradeoffs are an essential part of the Well-Architected Framework, as they help you understand the implications of design decisions on other pillars. Design patterns are reusable solutions to common problems that you might encounter when designing a workload. They help you understand how to design your workload to meet the goals of the Well-Architected Framework. Check out the updated articles:

September 2024

New articles

  • Azure Well-Architected Framework perspective on Azure NetApp Files: Explore design considerations and configuration recommendations for Azure NetApp Files. Azure NetApp Files is a fully managed file share service that supports the Server Message Block (SMB) protocol and Network File System (NFS) protocol. Learn how you can use Azure NetApp Files for file sharing, high-performance computing, home directories, and databases.

Updated articles

August 2024

Updated articles

  • Recommendations for defining reliability targets: We made significant updates, including new guidance on composite SLOs. The updated content links to guidance about how to focus on realistic expectations and build a health model to define system states.

We added guidance about ensuring that the VMs in your backup environment run on OSs that have supportability:

Hybrid retirement

  • This month, we announced the deprecation of Hybrid documentation in the repo. The content was outdated and no longer aligned to the Azure Well-Architected Framework.

July 2024

New articles

  • Azure Well-Architected Framework perspective on Azure Stack HCI: Explore design considerations and configuration recommendations for Azure Stack HCI. Azure Stack HCI is a hyperconverged infrastructure (HCI) solution that hosts virtualized Windows and Linux workloads and their storage in a hybrid on-premises environment. Learn how you can use Azure Stack HCI and Azure Arc capabilities to keep business systems and application data on-premises to address data sovereignty, regulation and compliance, and latency requirements.

Updated articles

Find updated guidance on using flexible virtual machine scale sets instead of availability sets for deployment across multiple zones:

Carrier Grade retirement

  • This month we announced the deprecation of the Carrier Grade documentation. The content was outdated and no longer relevant to the Azure Well-Architected Framework.

June 2024

Updated articles

May 2024

New articles

  • Azure Well-Architected Framework perspective on Azure Files: Explore design considerations and recommendations for Azure Files and Azure File Sync. Azure Files is a fully managed file share service that supports the SMB protocol and Network File System (NFS) protocol. Azure File Sync is a service that enables you to centralize your organization's file shares in Azure Files, while keeping the flexibility, performance, and compatibility of an on-premises file server.

Updated articles

April 2024

New articles

This month, we added two new service guides and new documentation about Oracle workloads on Azure infrastructure as a service (IaaS).

Service guides

Oracle workloads on Azure

Find new articles and updated guidance about Oracle workloads on Azure. Explore best practices to help you create a performant, secure, and highly available solution. To get started, see Oracle workloads on Azure infrastructure as a service (IaaS).

March 2024

New articles

  • Health modeling for workloads: Use health modeling to improve workload reliability in Azure. Differentiate between healthy, degraded, and unhealthy states. Learn how to quantify application health and build your own health model.
  • Azure Well-Architected Framework review for Log Analytics: Learn about the architectural recommendations for Log Analytics workspaces in Azure Monitor. These workspaces are the primary log and metric sink for a large portion of the monitoring data. Workspaces support multiple features in Azure Monitor, including ad-hoc queries, visualizations, and alerts.

Updated articles

February 2024

New articles

Updated articles

January 2024

In January, we added two new articles, and we updated two articles.

New articles

  • In Virtual Machines and scale sets, find guidance about how to review your virtual machine and scale set workloads by using the Well-Architected Framework. Use the Azure Virtual Machines compute service to create and run virtual machines on the Azure platform. You can choose from different SKUs, operating systems, and configurations.

  • In Optimize workload design using flows, learn how to optimize workloads through structured flow design. Take a look at a three-step process for workload optimization, including defining flow structures, setting technical requirements, and designing flows to meet these specifications. As you work to align flows with business processes and use cases, find practical examples and recommendations in this article.

Updated articles

Find updates to the following articles in the Operational Excellence pillar:

  • In Recommendations for implementing automation, find information about how to use Azure Update Manager to help you manage and govern updates for virtual machines. You can monitor Windows and Linux update compliance across your workload. You can also use Update Manager to make real-time updates or schedule them within a defined maintenance window.

  • In Recommendations for enabling automation in a workload, find a new section about using Azure Monitoring Agent for change tracking and inventory. Automate drift detection, the inventory-running services, and installed packages on the virtual machines in your workload.

December 2023

In December, we added a workload and updated recommendations for two Well-Architected Framework pillars.

New article

We added a new workload for workload owners, technical stakeholders, and business stakeholders. This documentation is appropriate for roles that are accountable for designing, building, and maintaining a solution for running applications and desktops in a cloud environment. Use the Azure Virtual Desktop workloads documentation as your go-to resource for optimizing the way you operate applications and desktops in Azure Virtual Desktop.

Updated articles

Updated recommendations for the Reliability pillar:

Updated recommendations for the Operational Excellence pillar:

November 2023

The Azure Well-Architected Framework completed a significant content refresh across all five pillars. We're breaking from our standard "What's new" format this month because the changes that launched with Microsoft Ignite 2023 go beyond bullet points.

The core pillars of architecture have been restructured

All five pillars of the Well-Architected Framework now follow a common structure that consists exclusively of design principles, design review checklists, tradeoffs, recommendation guides, and cloud design patterns.

Well-Architected Framework assessments

The Well-Architected Review assessment was refreshed. Specifically, the "Core Well-Architected Review" option now aligns to the new content structure in the Well-Architected Framework. Every question in every pillar maps to the design review checklist for that pillar. All choices for the questions correlate to the recommendation guides for the related checklist item.

Important

Backwards compatibility notice. The first new milestone on existing Core Well-Architected Review assessment sessions will not be prefilled with your prior responses due to the assessment refresh. You will be able to access prior milestones, but when you create the first new milestone, you will need to reassess the workload against the new questions and choices.

No other assessments were changed as part of this refresh.

Thematic changes

In addition to the changes in structure and consistency, you should note some thematic changes within the content. See the following key examples of these changes.

  • Workloads are more than technology. The scope of the Well-Architected Framework is your workload. The principles and the guides provide recommendations for people and processes of the workload team along with technical guidance.

  • Workloads exist within the context of the organization. The Well-Architected Framework frequently addresses workload responsibility to organizational expectations. The Well-Architected Framework calls out the benefits and tradeoffs of organizational influence.

  • Prior to this refresh, the guidance was more focused on the infrastructure than on the application running on that infrastructure. Now, every pillar has developer-centric content.

  • Specific service configuration has been minimized. The Well-Architected Framework pillar content is design content, not implementation content. Before the refresh, the Well-Architected Framework interwove Azure service-specific guidance and design guidance. Now, the Well-Architected Framework limits service-specific content to dedicated sections in the recommendation guides. The Well-Architected Framework service guides continue to exist to serve as the primary source for service-centric perspectives.

Important

As part of this restructuring, many pages have been added, moved, removed, or changed. Redirection is in place where possible, but we're aware that many existing links to the Well-Architected Framework might no longer point to the same content.

What didn't change?

  • The Well-Architected Framework continues to put a healthy burden on workload teams. It ensures that workload teams know what decisions need to be made and what risks, benefits, and tradeoffs are associated with those decisions.

  • The Well-Architected Framework provides recommendations to help you make informed and justified decisions. The Well-Architected Framework doesn't know your business requirements or constraints, so it can't make decisions for you.

  • The Well-Architected Framework workloads and the Well-Architected Framework service guides didn't undergo significant changes with this refresh. New workloads and service guides are ongoing additions to the Well-Architected Framework. Keep checking this page for updates.