Please ensure you have reviewed the Setup Guide Overview before beginning the steps outlined below.
Getting Started with Cloudability Credential Setup for Azure MCA Customers
Following these steps should result in:
- the creation of 2 CSV formatted files: one file for actual cost data and one file for amortized cost data
- the addition of Cloudability’s “Billing Account Reader” Service Provider to your MCA. this is a read-only role and will enable us to view products purchased for your account - like Azure Reservation purchases, Azure Marketplace purchases, and information like Azure product price sheets, and taxes.
|Note: both CSV formatted files are required by the Cloudability platform and must be present in the storage account being used to collect cost management data.|
Before you begin the steps below, please ensure you login to the Azure portal and have access to your organization's billing account by selecting the Billing Account scope for your MCA. For example, see the pic here:
Adding Cloudability’s SP and Creating Billing Data Exports in the Azure Portal
from the Azure Portal, search for "Cost Management + Billing" and select it from the list to open the Billing Scope page. For example:
from your Cost Management + Billing console, ensure you have selected the Billing Scope for your MCA; if you have multiple, select the scope with the majority of your cloud spend.
after selecting your billing account in the Cost Management + Billing console, find the “Access Control (IAM)” menu item from the left-side panel and click it to open the Access Control console page
from the Access Control (IAM) page, click the “Add” button and select the “Billing account reader” role from the right-side panel dropdown menu
after selecting the “Billing account reader” role from the dropdown, search for Cloudability’s SP by typing the first few letters “CloudabilityUtil” and find it in the search results
click on the “CloudabilityUtilizationDataCollector” SP to select it and then click the “Save” button at the bottom of the right-side panel
from the Cost Management + Billing console, find the "Export" menu item from the left-side panel under the "Settings" category and click it to open the Azure export utility
click the "Add" button to open the export page for creating a new CSV export
on the new export page, fill in the export details form to:
a. provide a filename for your export
b. select a cash basis for your export; this will be either "actual cost" or
c. select the export type to be "Daily export of month-to-date costs"
d. confirm the start_date is the current day
e. select an existing or create a new (recommended) storage destination for
the export and provide a single root directory for both CSV files.
repeat the steps 9a.->9d (above) to export cost data for the other cash basis and this time use the storage selected/created for 9e.
friendly reminder: following these steps should result in the creation of 2 CSV formatted files: one file for actual cost data and one file for amortized cost data.
Gathering Billing Data Info for Your Cloudability Credential Setup
Now that you've completed the steps for creating a billing data export, we’ll need some information from your Azure Portal for the Cloudability Credential setup.
What information does Cloudability need?
All the properties can be found using the Azure Portal Cost Management console. Please lookup and save the following information for use later:
How-to find it
ø tenant id
ø billing account id
ø subscription id
ø container name
Configuring Your Cloudability Credential using the Billing Data Info
Once you’ve gathered the information from the table above, you will be entering it into the Cloudability Credentials Azure UI for your MCA credential.
Cloudability will use that information to generate a PowerShell script that you can download and run from your Cloud Shell to grant the Cloudability Storage Blob Data Reader role access to the storage account that was designated for billing data.
navigate to the Cloudability Credentials Azure UI (direct link here)
click to create a new credential for your MCA, for example:
when the side panel opens, select “Microsoft Customer Agreement” from the dropdown and enter the information gathered from your Azure Portal into the corresponding UI fields. see an example here: https://share.getcloudapp.com/mXu6LBw0
click “Generate Setup Script” to download the new script file
click the “Close” button for now; you will return to verify the changes.
Granting Cloudability Access from the Azure Portal
The next step is to grant Cloudability access to read the cost & usage data from your Azure storage.
Once the information outlined in the previous table has been input to the Cloudability Azure Credentials UI and a setup script created, you will run the setup script in your Azure Portal Cloud Shell.
These commands will enable the Storage Blob Data Reader Role for Cloudability to access the storage account that has the exported CSV files.
to run the script:
- login to the Azure Portal and switch to the required Tenant
(aka directory that is the highest level of in Azure for the target enrollment)
- from the Azure Portal launch the Cloud Shell and select PowerShell as the scripting language
- once the Cloud Shell has initialized, select "Upload" from the Cloud Shell terminal menu
- upload the setup script file provided by Cloudability
- once the file has been uploaded, run the script by typing
Complete the Setup from the Cloudability UI
The final step to complete the setup is to verify your updated Cloudability MCA credential.
return to the Cloudability Credentials Azure UI (direct link here)
click to edit your MCA credential - for example:
click on the “Verify Credential” button at the bottom of the side panel; you Azure Credential will have green checkbox under the “Billing Reports” column once it has been validated.
|Please allow 8 hours for your cost and usage billing data to populate.|