docs: Add Data Explorer SKU availability guidance#2116
Open
MSBrett wants to merge 4 commits into
Open
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
Collaborator
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
Contributor
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.