Connecting to Azure

Connections are how CloudZero manages the Cost Sources that bring Billing, Resources, and other types of data into the platform.

How the Azure Connection Works

Connecting CloudZero to an Azure account shows Azure cost data alongside other Cost Sources in the Explorer and enables anomaly alerts on Azure spend.

Depending on the Azure account type and billing scope, this includes the following data:

  • Daily and monthly usage data
  • Billing data
  • Data from invoices and balances, including taxes and discounts applied

You connect CloudZero to Azure by enabling the CloudZero multi-tenant service principal in your tenant and granting it read-only access to the Azure Cost Management + Billing APIs.

📘

All of CloudZero's Azure Permissions are Read-Only

CloudZero has no access to read data except where explicitly authorized. For example, the Billing Reader role grants CloudZero permission to read usage and billing data for a specific subscription, but not to query resource configurations.

How to Connect to Supported Azure Agreement Types

Microsoft Azure accounts can have different agreement types that affect how usage and billing data can be collected.

To get started with an Azure connection, select your agreement type from the following list:

Accounts obtained through other agreements, such as the Microsoft Online Services Program or other MSDN-based agreements, do not support exporting usage data and cannot be connected to CloudZero.

To check which agreement type you have, see the Azure documentation.

How to Migrate Microsoft EA to Microsoft MCA

There may be situations in which your organization moves from Microsoft Enterprise Agreement (EA) to a Microsoft Customer Agreement (MCA). To achieve a clean migration of your connections and maintain data continuity within CloudZero, follow these steps.

  1. Add the new Microsoft Customer Agreement (MCA) account as a net new connection by following the steps on the page Connecting to an Azure MCA Account.
  2. Navigate to Settings > Cloud Integrations and pause the existing Enterprise Agreement (EA) connection.

After you pause the EA connection, data will begin to flow in over the new MCA connection instead of the EA connection.

It is critical to pause, not delete, this connection in order to maintain historical data in CloudZero. If the Enterprise Agreement is deleted, you will lose access to all data associated with that connection.

If you did not pause the EA connection earlier, it will begin to display an Error state as your account migrates over to the MCA. It is still critical to not delete the EA connection despite this error, as doing so will cause you to lose all historical data for that connection.