Skip to content

docs: Add Data Explorer SKU availability guidance#2116

Open
MSBrett wants to merge 4 commits into
devfrom
features/kusto-sku-preflight
Open

docs: Add Data Explorer SKU availability guidance#2116
MSBrett wants to merge 4 commits into
devfrom
features/kusto-sku-preflight

Conversation

@MSBrett

@MSBrett MSBrett commented May 1, 2026

Copy link
Copy Markdown
Contributor

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

File What
errors.md New error entry: "The sku {SkuName} is not supported in {region}" with PowerShell (Get-AzKustoSku) and REST API mitigation
deploy.md Simple note that not all SKUs are available in every region, links to errors page
template.md Cross-reference from dataExplorerSkuName parameter to errors page
deploy-finopshub.md [!NOTE] linking to errors page for SKU issues
finops-hubs-deployment.md Agent skill reference: availability commands and failure pattern

Context

Discovered during SRE Agent deployment to westusStandard_E4d_v5 is 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.

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 microsoft-github-policy-service Bot added the Needs: Review 👀 PR that is ready to be reviewed label May 1, 2026

@RolandKrummenacher RolandKrummenacher left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread docs-mslearn/toolkit/help/errors.md
Comment thread docs-mslearn/toolkit/help/errors.md
Comment thread docs-mslearn/toolkit/hubs/template.md Outdated
Comment thread docs-mslearn/toolkit/powershell/hubs/deploy-finopshub.md Outdated
Comment thread src/templates/agent-skills/finops-toolkit/references/finops-hubs-deployment.md Outdated
- 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
@MSBrett MSBrett enabled auto-merge (squash) June 3, 2026 23:20

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread src/templates/agent-skills/finops-toolkit/references/finops-hubs-deployment.md Outdated
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs: Review 👀 PR that is ready to be reviewed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants