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>
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.
- Clarify default SKU is Dev(No SLA)_Standard_D11_v2; E2a_v4 is lowest-cost - Bump Kusto skus API version from 2024-04-13 to 2025-02-14 - Deep-link to errors.md anchor for SKU-not-supported section - Update ms.date to today Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…flight # Conflicts: # docs-mslearn/toolkit/hubs/deploy.md
There was a problem hiding this comment.
Pull request overview
Adds Azure Data Explorer (Kusto) SKU regional availability troubleshooting guidance to FinOps Hubs documentation, so users can self-serve when deployments fail due to unsupported SKUs in a given region.
Changes:
- Added a new “SKU not supported in region” troubleshooting entry with PowerShell (
Get-AzKustoSku) and ARM REST API guidance. - Added cross-references/notes in hub deployment and template docs pointing users to the canonical errors page.
- Updated the FinOps Hubs deployment agent-skill reference to include the SKU availability check pattern.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| src/templates/agent-skills/finops-toolkit/references/finops-hubs-deployment.md | Adds SKU availability check guidance and the common failure pattern to the deployment reference used by agents. |
| docs-mslearn/toolkit/powershell/hubs/deploy-finopshub.md | Adds a NOTE linking SKU failures to the canonical “common errors” entry; updates ms.date. |
| docs-mslearn/toolkit/hubs/template.md | Cross-references the SKU availability error from the dataExplorerSkuName parameter; updates ms.date. |
| docs-mslearn/toolkit/hubs/deploy.md | Adds a regional SKU availability reminder and link to the canonical error entry; updates ms.date. |
| docs-mslearn/toolkit/help/errors.md | Adds the canonical troubleshooting entry for “The sku {SkuName} is not supported in {region}”; updates ms.date. |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
RolandKrummenacher
left a comment
There was a problem hiding this comment.
Re-review ✅ — all items from the first round are resolved, verified against the source of truth (not just the "Fixed in…" replies):
- Default SKU — now correctly states
Dev(No SLA)_Standard_D11_v2is the default andE2a_v4the lowest-cost option. Matchesmain.bicep(dataExplorerSku = 'Dev(No SLA)_Standard_D11_v2'). - api-version — bumped to
2025-02-14in botherrors.mdand the agent-skill reference. - Deep-links —
template.md,deploy.md, anddeploy-finopshub.mdall link to#the-sku-skuname-is-not-supported-in-region; anchor slug is correct (braces stripped, inner text kept). {location}/{region}consistency — agent-skill reference now uses{region}throughout.
One trivial, non-blocking note: in errors.md the REST URL keeps {location} and the cmdlet example uses -Location — that's fine since those mirror the actual Azure API path segment and cmdlet parameter.
Docs-only, additive, follows the canonical "errors.md is home, everything links there" pattern. Good to merge.
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.