For the latest version of this help, see: https://help.apptio.com/en-us/cloudability/admin/azure-amortized-costs.htm
Please ensure you have reviewed the Setup Guide Overview before beginning the steps outlined below for updating your Cloudability Azure credentials to enable access to amortized cost data.
Updating Your Cloudability Credential Setup for Azure EA 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
|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 EA enrollment by selecting the Billing scope for your EA. For example, see the pic here:
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 EA; if you have multiple, select the scope with the majority of your cloud spend.
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 5a.->5d (above) to export cost data for the other cash basis and this time use the storage selected/created for 5e.
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
ø api access key
ø subscription id
ø container name
Updating 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 EA 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 edit your EA credential, for example:
when the side panel opens, enter your EA API Access Key and the other information gathered from your Azure Portal into the corresponding UI fields; see the example here: https://share.getcloudapp.com/2NujOj4P
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 EA credential.
return to the Cloudability Credentials Azure UI (direct link here)
click to edit your EA 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.
|Important: ensure that
(i) all your EA Cloudability credentials have been updated with these steps and
(ii) you remember and socialize your Azure amortized cost cutover date
if you have >1 EA credential, you must follow these steps for all your EA credentials.
Once these steps have been completed for all your EA credentials, Cloudability will automatically detect your Azure v2 cutover date.
What is the Azure v2 cutover date?
This represents the earliest date for which you provided enhanced billing data to Cloudability (including amortized cost data) from the new Azure billing data source.
By establishing the "Azure v2" cutover date, Cloudability can distinguish between (i) the enhanced billing data which includes amortized cost from the “new Azure billing data source” and, (ii) billing data from the “original Azure data source”, which does not include any enhancements (or amortized cost data).
For example: if it is December and you have provided CSV export files for each month from January to November, then your Azure v2 cutover date will be automatically set to January 1st.
It is important to be aware of this cutover date because reports that surface cost data across the cutover date boundary will represent an aggregation of “original” and “new” billing data - this could potentially lead to confusion. for example: “original” billing data does not include any amortized cost data
|Please allow 8 hours for your enhanced cost and usage billing data to populate.|