docs: Add Data Explorer SKU availability guidance#2116
Conversation
Add SKU regional availability information across FinOps Hubs documentation:
- errors.md: New error entry for 'The sku {SkuName} is not supported in {region}'
with PowerShell (Get-AzKustoSku) and REST API mitigation steps
- deploy.md: Note SKU regional availability in deployment steps
- template.md: Cross-reference errors page from dataExplorerSkuName parameter
- deploy-finopshub.md: Add note linking to errors page for SKU issues
- finops-hubs-deployment.md: Add SKU availability commands to agent skill reference
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
microsoft-github-policy-service
Bot
added
the
Needs: Review 👀
RolandKrummenacher
left a comment
RolandKrummenacher
left a comment
There was a problem hiding this comment.
Five files, clean canonical pattern (errors.md as home, others link there). Two factual issues to fix before merge, plus a couple of nice-to-haves — see inline comments.
| 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> | ||
|
|
There was a problem hiding this comment.
Wrong default SKU. This says Dev(No SLA)_Standard_E2a_v4 is "the default dev/test SKU," but the actual Bicep template default is Dev(No SLA)_Standard_D11_v2 (src/templates/finops-hub/main.bicep:122) — and template.md:88 in this same PR confirms D11_v2.
E2a_v4 is the cheaper option the agent skill recommends to start with, but it's not the deployed default. Either:
- change to
Dev(No SLA)_Standard_D11_v2, or - reword to something like "the lowest-cost dev/test SKU (
Dev(No SLA)_Standard_E2a_v4) is available in most regions" if that was the intent.
|
|
||
| ```http | ||
| GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Kusto/locations/{location}/skus?api-version=2024-04-13 | ||
| ``` |
There was a problem hiding this comment.
Stale api-version. 2024-04-13 is valid but not current. Latest stable for Microsoft.Kusto/locations/{location}/skus is 2025-02-14 (per Skus - List). For a brand-new doc entry, prefer the latest stable.
Same stale version is duplicated in src/templates/agent-skills/finops-toolkit/references/finops-hubs-deployment.md — update both.
| | **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". | | |
There was a problem hiding this comment.
Nice-to-have: deep-link to the new section anchor instead of the page top — ../help/errors.md#the-sku-skuname-is-not-supported-in-region. Matches the pattern in changelog.md (errors.md#403, errors.md#dataexploreringestionfailed). Worth verifying the anchor renders — Microsoft Learn typically strips { } from heading slugs.
Same applies to the new links in deploy.md and deploy-finopshub.md.
| | `‑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). |
There was a problem hiding this comment.
Nit: deep-link to the new anchor — ../../help/errors.md#the-sku-skuname-is-not-supported-in-region — so users land on the section, not the top of a 1000-line page.
| | 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}"`. |
There was a problem hiding this comment.
Same stale api-version=2024-04-13 as in errors.md — bump to 2025-02-14.
2 participants
Summary
Adds Data Explorer (Kusto) SKU regional availability information across FinOps Hubs documentation so users can self-serve when they hit SKU deployment failures.
Changes
errors.mdGet-AzKustoSku) and REST API mitigationdeploy.mdtemplate.mddataExplorerSkuNameparameter to errors pagedeploy-finopshub.md[!NOTE]linking to errors page for SKU issuesfinops-hubs-deployment.mdContext
Discovered during SRE Agent deployment to
westus—Standard_E4d_v5is not available there for Kusto clusters. The existing docs mention SKU selection but not how to verify regional availability or what to do when it fails.The errors page (
errors.md) is the canonical home for this — all other docs just link there. No alarmist callouts; just makes the information available where people need it.