docs: Add Data Explorer SKU availability guidance

docs-mslearn/toolkit/help/errors.md

@@ -3,7 +3,7 @@ title: Troubleshoot common FinOps toolkit errors
 description: This article describes common FinOps toolkit errors and provides solutions to help you resolve issues you might encounter.
 author: flanakin
 ms.author: micflan
-ms.date: 04/04/2026
+ms.date: 05/01/2026
 ms.topic: troubleshooting
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -907,6 +907,30 @@ Open the subscription in the Azure portal, then select **Settings** > **Resource
 
 <br>
 
+## The sku {SkuName} is not supported in {region}
+
+<sup>Severity: Critical</sup>
+
+The Azure Data Explorer cluster deployment failed because the selected SKU isn't available in the target region for your subscription. Not all Data Explorer SKUs are available in every region.
+
+**Mitigation**: Check which SKUs are available in your region and choose one that's supported.
+
+Using Azure PowerShell (requires the [Az.Kusto](/powershell/module/az.kusto) module):
+
+```powershell
+Get-AzKustoSku -Location "westus"
+```
+
+Using Azure REST API:
+
+```http
+GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Kusto/locations/{location}/skus?api-version=2024-04-13
+```
+
+If your preferred SKU isn't listed, choose a different SKU or deploy to a region where it's available. The default dev/test SKU (`Dev(No SLA)_Standard_E2a_v4`) is available in most regions. For help choosing a SKU, see [Select a SKU for your Azure Data Explorer cluster](/azure/data-explorer/manage-cluster-choose-sku).
+
+<br>
+
 ## x_PricingSubcategory shows the commitment discount ID
 
 Cost Management exports before February 28, 2024 had a bug where `x_PricingSubcategory` was being set incorrectly for committed usage. You should expect to see values like `Committed Spend` and `Committed Usage`. Instead, you might see values like:

docs-mslearn/toolkit/hubs/deploy.md

@@ -3,7 +3,7 @@ title: How to create and update FinOps hubs
 description: This tutorial helps you create a new or update an existing FinOps hubs instance in Azure or Microsoft Fabric.
 author: flanakin
 ms.author: micflan
-ms.date: 04/21/2026
+ms.date: 05/01/2026
 ms.topic: tutorial
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -157,7 +157,7 @@ The core engine for FinOps hubs is deployed via an Azure Resource Manager deploy
    - We don't recommend changing either setting for your initial deployment.
    - If using Data Explorer, the storage account is a temporary data store and shouldn't need geo-redundancy.
    - Most deployments doesn't require a larger Data Explorer SKU. We recommend starting with the dev/test cluster and monitoring performance before scaling up or out.
-   - For details about scaling Data Explorer, see [Select a SKU for your cluster](/azure/data-explorer/manage-cluster-choose-sku).
+   - Not all Data Explorer SKUs are available in every region. If you change the SKU, confirm it's available in your target region first. See [Select a SKU for your cluster](/azure/data-explorer/manage-cluster-choose-sku) for guidance and [common errors](../help/errors.md) if deployment fails.
 8. Select the **Next** button at the bottom of the form.
 9. Set the desired data retention periods.
    - Raw data retention refers to data added to Data Explorer, but not normalized into the final tables. Use 0 unless you need to troubleshoot ingestion issues. This number indicates retention in days.

docs-mslearn/toolkit/hubs/template.md

@@ -3,7 +3,7 @@ title: FinOps hub template
 description: Learn about what's included in the FinOps hub template including parameters, resources, and outputs.
 author: flanakin
 ms.author: micflan
-ms.date: 04/13/2026
+ms.date: 05/01/2026
 ms.topic: concept-article
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -85,7 +85,7 @@ Here are the parameters you can use to customize the deployment:
 | **location**                           | String | Optional. Azure location where all resources should be created. See <https://aka.ms/azureregions>.                                                                                                                                                                                                                                       | Same as deployment |
 | **storageSku**                         | String | Optional. Storage SKU to use. LRS = Lowest cost, ZRS = High availability. Note Standard SKUs are not available for Data Lake gen2 storage. Allowed: `Premium_LRS`, `Premium_ZRS`.                                                                                                                                                      | "Premium_LRS"      |
 | **dataExplorerName**                   | String | Optional. Name of the Azure Data Explorer cluster to use for advanced analytics. If empty, Azure Data Explorer will not be deployed. Required to use with Power BI if you have more than $2-5M/mo in costs being monitored. Default: "" (do not use).                                                                                  |                    |
-| **dataExplorerSkuName**                | String | Optional. Name of the Azure Data Explorer SKU. Default: "Dev(No SLA)_Standard_D11_v2".                                                                                                                                                                                                                                                 |                    |
+| **dataExplorerSkuName**                | String | Optional. Name of the Azure Data Explorer SKU. Not all SKUs are available in every region. If deployment fails, see [common errors](../help/errors.md). Default: "Dev(No SLA)_Standard_D11_v2".                                                                                                                                                                 |                    |
 | **dataExplorerSkuTier**                | String | Optional. SKU tier for the Azure Data Explorer cluster. Use Basic for the lowest cost with no SLA (due to a single node). Use Standard for high availability and improved performance. Allowed values: Basic, Standard. Default: "Basic".                                                                                              |                    |
 | **dataExplorerSkuCapacity**            | Int    | Optional. Number of nodes to use in the cluster. Allowed values: 1 for the Basic SKU tier and 2-1000 for Standard. Default: 1.                                                                                                                                                                                                         |                    |
 | **tags**                               | Object | Optional. Tags to apply to all resources. We will also add the `cm-resource-parent` tag for improved cost roll-ups in Cost Management.                                                                                                                                                                                                 |                    |

docs-mslearn/toolkit/powershell/hubs/deploy-finopshub.md

@@ -3,7 +3,7 @@ title: Deploy-FinOpsHub command
 description: Deploy a new or update an existing FinOps hub instance using the Deploy-FinOpsHub command in the FinOpsToolkit module.
 author: flanakin
 ms.author: micflan
-ms.date: 04/01/2026
+ms.date: 05/01/2026
 ms.topic: reference
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -51,6 +51,9 @@ Deploy-FinOpsHub `
 | `‑RemoteHubStorageKey`   | Optional. Storage account access key for the remote hub. Used for cross-tenant cost data collection scenarios. Must be kept secure as it provides full storage access. |
 | `‑Tags`                  | Optional. Tags for all resources.                                                                                                                                                   |
 
+> [!NOTE]
+> Not all Data Explorer SKUs are available in every region. If deployment fails with a SKU error, see [common errors](../../help/errors.md).
+
 <br>
 
 ## Examples

src/templates/agent-skills/finops-toolkit/references/finops-hubs-deployment.md

@@ -67,6 +67,8 @@ Deploy using one of these links:
 | Storage SKU | `Premium_LRS` or `Premium_ZRS` | Default (LRS) for initial deploy |
 | Data Explorer SKU | Cluster size | `Dev(No SLA)_Standard_E2a_v4` to start |
 
+**Data Explorer SKU availability:** Not all SKUs are available in every region. To check availability, use `Get-AzKustoSku -Location "{region}"` or query `GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Kusto/locations/{location}/skus?api-version=2024-04-13`. If the selected SKU isn't available, deployment fails with `"The sku {SkuName} is not supported in {region}"`.
+
 ### PowerShell
 
 ```powershell