Skip to main content
Matrix42 Self-Service Help Center

Installing and configuring the Matrix42 Cloud Costs data provider


The Matrix42 Cloud Costs data provider comes as an add-on and can be downloaded from the Extension Gallery. It needs to be configured to be able to import data from your cloud provider.

ArchitecturePublic Cloud Provider: The web resource where you have a contract with subscriptions to use PaaS or IaaS. The provider may be Microsoft, Amazon or Google.


Matrix42 Cloud Provider API: A cloud service provided by Matrix42 offering a generic API to access the different cloud providers in a common way. This interface also allows intelligent and efficient incremental updates so that it is not required to download all data whenever the data provider is running. 


Matrix42 Data Provider: The Matrix42 Cloud Costs data provider holds the credentials to access your contract at the public cloud provider. He requests the download of all billing information and receives the data records to store them in the Matrix42 SAM tool. 


Matrix42 SAM Tool:  The inventory of all contracts, hardware, software, cloud resources and licenses stored and managed in organizational context. Based on this data you reconcile your assets with your demand for reporting, analysis and decision making. 

Communication between Data Provider and the Cloud Provider API uses https and port 443. If required, white-list following URLS in your firewall or proxy:

Configuring the Matrix42 Cloud Costs data provider

To configure the data provider:

  1. Open the Administration application and go to Integration > Data Providers.
  2. Double-click the Matrix42 Cloud Costs data provider to open it. The page contains the configurations list where configurations for this provider can be managed.
  3. Create a new configuration. A new dialog will open.
  4. Under General Settings keep Enable import selected.
  5. Under Cloud Costs Settings start with choosing a contract. This contract should have a defined business partner and internal contact. The business partner value will be assigned as Manufacturer for stock keeping units that will be created by the import. The internal contact value is important if you need the import to also create services and service bookings in the Service Catalog application.

Preferably, this contract should match a contract on the cloud costs portal for which the data will be imported. See Select Registered Contract on Azure Costs Portal below.

  1. Select a team for which you want to import cloud costs data.
  2. In the Select Registered Contract on Azure Costs Portal drop-down field, you need to choose one of the contracts that are registered for the selected team on the portal. A separate data provider configuration should be set up for each contract if you wish to import data for several contracts of one team or different teams.


If the Select Registered Contract on Azure Costs Portal drop-down field is empty, you need to register your contract on the portal.

  1. After you select the contract, save the dialog and run the Test Configuration action at the top of the dialog to check the connection to the portal.
  2. Save the data provider.
  3. To import the cloud costs data, run the Enable and Activate action for the data provider.

Registering a new contract 

It might be the case that the Select Registered Contract on Azure Costs Portal drop-down field does not contain any contracts, it means that no contracts have been registered for the selected team on the cloud costs portal. In this case you can use the Register Your Contract button to add a contract on the portal without switching to the portal interface.

To add a contract:

  1. Click the Register Your Contract button. The wizard opens.
  2. Select the type of contract you want to add (Microsoft Enterprise Agreement for Azure, Amazon Web Services or Google Cloud Platform Account) and proceed to the next page.
  3. Based on the selected SaaS provider, you need to enter contract details. For example, for Microsoft Azure Contract you have to fill in the security token.


To find out how to get the required contract details, you can use the following links: 

Tracking the import progress

Click the configuration of the Matrix 42 Cloud Costs data provider to open its preview.

The preview displays all jobs, workflow instances, and import logs for the selected configuration. By clicking links for separate import logs, you can see the details of importing each type of data.

You can also review jobs, workflow instances, and import logs on the separate tabs of the configuration dialog.

  • Was this article helpful?