Skip to content

Document correct backfill order and MCA billing profile requirements for FinOps Hubs - #1733

Merged
Arthur Clares (arthurclares) merged 3 commits into
devfrom
copilot/fix-1729
Jul 8, 2025
Merged

Document correct backfill order and MCA billing profile requirements for FinOps Hubs#1733
Arthur Clares (arthurclares) merged 3 commits into
devfrom
copilot/fix-1729

Conversation

Copilot AI commented Jul 1, 2025

Copy link
Copy Markdown
Contributor

This PR addresses critical documentation gaps that were causing users to experience missing Reserved Instance (RI) savings in Data Explorer reports when backfilling historical data.

Problem

Users migrating from Storage to Data Explorer versions of FinOps Hubs encountered:

  • Missing RI savings calculations in historical Data Explorer reports (only showing in current month)
  • Confusion about MCA billing profile vs billing account scope requirements for certain exports
  • No clear guidance on correct backfill order or how to fix incorrect backfills

Root Cause

The issue occurred when users backfilled cost data before price data, causing the Data Explorer ingestion process to miss price information needed for accurate savings calculations.

Solution

Enhanced documentation with:

📋 Clear Backfill Order Requirements

  • Prominent warnings explaining why order matters for RI/savings plan calculations
  • Step-by-step guidance for both Azure portal and PowerShell approaches
  • Specific examples showing correct export sequence

🔧 MCA Billing Profile Requirements

  • Explicit documentation that price sheet, reservation recommendations, and reservation details exports must use billing profile scope for MCA contracts
  • Clear explanation that this is a Cost Management limitation, not a FinOps Hubs requirement

🚨 Troubleshooting Guidance

  • Detailed recovery steps for users who already backfilled in wrong order
  • Pipeline re-run instructions to reprocess cost data after price data becomes available
  • Verification steps to confirm the fix worked

Files Changed

  • docs-mslearn/toolkit/hubs/deploy.md: Enhanced backfill section, added troubleshooting, improved PowerShell examples
  • docs-mslearn/toolkit/hubs/configure-scopes.md: Added MCA billing profile requirements with warning callouts
  • docs-mslearn/toolkit/hubs/data-processing.md: Fixed typo in price processing description

Impact

  • ✅ Prevents missing RI savings in Data Explorer reports for new deployments
  • ✅ Provides clear recovery path for users who already have the issue
  • ✅ Eliminates confusion about MCA export scope requirements
  • ✅ Improves overall user experience with clearer step-by-step guidance

Fixes #1729.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI changed the title [WIP] Document correct order for backfilling price and cost data in the Deployment Guide Document correct backfill order and MCA billing profile requirements for FinOps Hubs Jul 1, 2025
@arthurclares
Arthur Clares (arthurclares) marked this pull request as ready for review July 8, 2025 09:54
@arthurclares
Arthur Clares (arthurclares) deleted the copilot/fix-1729 branch July 8, 2025 09:56
@microsoft-github-policy-service

Copy link
Copy Markdown

All Contributors (@all-contributors) please add Copilot for doc

@allcontributors

Copy link
Copy Markdown
Contributor

@microsoft-github-policy-service[bot]

Could not find the user Copilot on github.

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 Skill: DevOps GitHub setup and automation Skill: Documentation Documentation updates Tool: FinOps guide Implementing FinOps guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document correct order for backfilling price and cost data in the Deployment Guide

6 participants