Upgrading FinOps hubs Upgrade an existing FinOps hub instance to the latest version to leverage new capabilities.

Get started Deploy

On this page

Upgrading a FinOps hub instance is usually the same as the initial setup but depending on what version you’re moving from or to, you may have specific steps that are needed. Use the following sections to move from one version to another. If you have any questions, please start a discussion.

The most common issue people face when upgrading to 0.2 is trying to use new Power BI reports with an old hub or using old Power BI reports with an upgraded hub. FinOps hubs and reports from the 0.0.1 and 0.1.x releases are compatible, but they are not compatible with 0.2.


Before you begin

Before you upgrade, make sure you know what version you’re currently running. You can find the version in the storage account:

  1. Open the storage account in the Azure portal
    • You can navigate from the resource group or the list of storage accounts.
    • If you use the list of storage accounts, add a tag filter for cm-resource-parent contains Microsoft.Cloud/hubs to see all hub storage accounts.
  2. Open Storage browser > Blob containers > config
  3. Find the settings.json row and select the ⋯ menu on the right, then View/edit.
  4. Look for the version property.


Upgrading 0.0.1

FinOps hubs 0.0.1 was the initial release and was intentionally scoped down in capabilities to get something out that we could start to collect feedback on. This release was intended for supporting amortized cost only but it did not make any assumptions about the data, which means you could connect it to any export type or account type. Power BI reports in 0.0.1 only worked with Enterprise Agreement (EA) accounts. Refer to the subsections below if you have another account type.

Please use the following sections to determine the best steps to upgrade your hub instance.

MOSA and Microsoft internal subscriptions for 0.0.1

Microsoft Online Services Agreement (MOSA, aka PAYG) and Microsoft internal subscriptions are not supported in FinOps hubs 0.2 or later. You can use Power BI reports from the 0.1.1 release or the FinOps toolkit PowerShell module 0.1.1, but there is no need to upgrade your hub instance. Changes were internal or only apply to initial onboarding. Please contact support about transitioning to a Microsoft Customer Agreement account.

Download Install PowerShell

EA and MCA accounts for 0.0.1

If you have an EA or MCA account, please upgrade to 0.2 which uses the new FOCUS cost data format and covers both billed (actual) and amortized costs with 30% less data size (and storage costs). This will be the baseline for all future updates.

See 0.2 upgrade instructions


Upgrading 0.1.x

FinOps hubs received small internal updates in 0.1 and 0.1.1.

Please use the following sections to determine the best steps to upgrade your hub instance.

MOSA and Microsoft internal subscriptions for 0.1.x

Microsoft Online Services Agreement (MOSA, aka PAYG) and Microsoft internal subscriptions are not supported in FinOps hubs 0.2 or later. You can use Power BI reports from the 0.1.1 release or the FinOps toolkit PowerShell module 0.1.1, but there is no need to upgrade your hub instance. Please contact support about transitioning to a Microsoft Customer Agreement account.

Download Install PowerShell

EA and MCA accounts for 0.1.x

FinOps hubs 0.2 and later use the FOCUS cost data format which covers both billed (actual) and amortized costs. FOCUS allows viewing EA and MCA data together and is 30% smaller than actual + amortized datasets combined, which reduces your (storage costs). See FOCUS benefits for additional benefits.

Cost Management has a limitation with the new exports that limits them to the last 13 months. If you need data older than 13 months, please contact support to request support for historical data. The following details are based on this current limitation (as of January 2024).

Before you upgrade, consider the following:

  1. How much data do you have in your hub instance?
    • If you have less than 13 months of data, we recommend you delete the data and re-export it using the FOCUS dataset.
    • If you have more than 13 months of data, you can keep the data in your storage account, but the new Power BI reports will not recognize it. You can continue to use the current Power BI reports.
  2. Did you modify the Power BI reports?
    • If you modified the reports, you will need to re-apply your changes to the new reports. Refer to How to update existing reports to FOCUS for details.
    • If you need your customized reports to continue to run while you upgrade, deploy a second instance of FinOps hubs using a different storage account to avoid data processing errors.

Based on the above, use the following steps to upgrade your hub instance from 0.1.x to 0.2.x:

  1. Delete any amortized cost exports pointing to your hub instance.
  2. If desired, delete the historical amortized cost data to keep storage costs down.
  3. Deploy FinOps hubs 0.2.1 and create new FOCUS exports using the Create a new hub instructions.

    You can skip step 1 since resource providers have already been registered.

  4. Backfill historical data using the FOCUS export.

Download


⏭️ Next steps


Deploy Learn more


This site uses Just the Docs, a documentation theme for Jekyll.