Pier Cloud Platform _ FOCUS Configuration for Azure
Focus Configuration Process for Azure Provider
Welcome to Pier Cloud!
Pier Cloud is our centralized platform for managing cloud data and services. Our focus is to ensure that access to resources is secure, convenient, and efficient. This document is designed to guide you through configuring Focus on the Azure provider.
Below, you will find a detailed process that explains each step clearly and objectively.
In the Azure environment
To start the configuration, access the Azure portal and, in the search field, look for "Microsoft Entra ID". Once you have found it, click on the name you searched for, as illustrated in the image below.
Here, select "App registrations" in the bottom left menu as shown in the image below.
Note: It is necessary to create a Service Principal to ensure that it has access to the container responsible for exporting the Billing Focus.
Here click on + New registration, to create the Service Principal.
In the Name field, enter the name that will be given to the Service Principal (App Registration). For this example, we will use the name “focus-teste”, but the customer can choose the name of their preference. In the Supported account types field, select the option Accounts in any organization directory (Any Microsoft Entra ID tenant - Multitenant). Then, click Register to create the Service Principal, as illustrated in the image below.
The Service Principal has been successfully created! Now let's create the Secret by clicking on Add a certificate or secret, as illustrated in the image below.
To start the configuration, access the Azure portal and, in the search field, look for "App registrations", after finding the name you searched for, click on the name.
In the window on the right, in the Description field, add the name for the secret (in this case, "focus-teste"). In the Expires field, select the expiration period for the secret (we will set it to 730 days in this example). Finally, click Add, as illustrated in the image below.
The Secret has been successfully created! Now copy the Value and Secret ID, save them in a notepad, and send them to the Pier Cloud team responsible for configuring the platform.
Service Principal (APP registration) and secret created successfully! Now we can move on to the next steps of the configuration.
To start the configuration, access the Azure portal and, in the search field, look for "Storage Accounts". Then, create a new storage account for Focus Billing.
Here click on + Create, as shown in the image below:
In this step, we will add the necessary information to create the Storage that will be used in the Focus Billing configuration, then click on Review + create.
Note: If you prefer to use existing storage, this is also possible without any problems.
Once the Storage has been created or an existing one has been used, we can continue with the configuration.
Click on the Storage that was created.
Here click on Access Control (IAM), in the menu on the left to add the Service Principal (App registration created in the previous step) to this storage account, as illustrated in the image below.
Here click on + Add, then click on Add role assignment, as shown in the image below.
Here click on Members.
Here click on + Select members.
In the search field, look for the Service Principal (App registration), created, click on the service principal to select it, then click on select, as illustrated in the image below.
Once the member is selected, now click on role, as illustrated in the image below.
Here in the search field, search for the role (in this case we will use the Reader role), select the searched role as illustrated in the image below.
Done, Member and read role added to Storage Account billingfocus, as illustrated in the image below. Now click on Review + assign, to continue with the next step.
Click on Storage Browser.
Click on the Blob containers, as shown in the image below:
Click on billingfocus, as shown in the image below:
Click on the billingfocus directory.
Click on pier-focus-cost.
Click on the directory 20240901-20240930, as shown in the image below:
Click on the directory 87a9e2b9-6e92-4c7f-9323-bb2b5d0598ff, as shown in the image below:
In this step, we will obtain information related to the path where the files will be saved and the format in which they will be stored.
Note: Make sure to save this information in a notepad as you will need it later to configure the platform. Example path: /billingfocus/pier-focus-cost/. Important: These files will only be available after the configuration is complete and Export is run.
Now, we need to configure Focus Billing. On the Azure portal home page, use the search field and look for Cost Export, as shown in the image below.
Select the scope that contains your configured Billing account, click on Scope, as illustrated in the image below.
Here, select the Pay-As-You-Go scope (the scope in which the billing account used in this documentation was configured), and then click Select.
After selecting the correct scope, click + Create.
Here select Cost and usage(FOCUS), as shown in the image below:
Here click on Add export.
Here, you must fill in the following fields:
Type of data: Select "Cost and usage details (FOCUS) - Preview".
Export name: Enter a name for identification.
Dataset version: Choose version 1.0.
Frequency: Select "Daily export of month-to-date cost".
Export description: This field is optional.
After filling it in, click Add to finish.
Export created successfully. We can move on to the next step.
In this step, enter a name in the Export Prefix field and then click Next to proceed.
Fill in and select the following fields:
Storage type: Choose the storage type. In this case, it will be "Azure Blob Storage".
Destination and storage: You can choose to use an existing storage or create a new one.
Subscription: Select the environment where the storage was created.
Container: Resource created within the storage that organizes directories and folders.
Directory: Directory with the path where the files will be saved.
Format: Choose the format of the file to be saved in the directory (select Parquet).
Compression type: Type of file compression (select Snappy).
After filling in and selecting all the options, click Next to continue.
Now, review all the information to ensure it is correct and click Create to finish creating the Export.
Export created and activated successfully as shown in the image below.
Note: To speed up the export process, you can click Run now.
On the Pier Cloud Platform
On the Platform home page, click on the user icon and then select Settings as shown in the image below:
In the menu on the left, select Secrets.
In the top right corner, click + Add.
Fill in the fields, as instructed below:
In the "Name" field, enter the name to identify the secret (Secret); in this example, we will use "Azure Focus".
In "Type", select the type of secret. In Azure, there are two types available: "Azure" and "Azure Billing". In this case, we will choose "Azure".
In the "Tenant ID" field, enter the Tenant ID obtained during the creation of the Service Principal (App Registration), as shown on step 8. Note: the field is blank so as not to expose the Tenant ID of the account used in the documentation.
In "Client ID", enter the key obtained in the "Application (client) ID" field from the process described on step 8.
In the "Client Secret" field, enter the value generated in the Secret creation process, shown on step 11.
Finally, click "Save" to complete the creation of the secret, as illustrated in the image below.
Done, Secret created successfully! Now we can proceed to the next step.
In the left menu, select Billing Connectors.
In this step, click on + Add Connector in the top right menu as shown in the image below.
Here, select FOCUS in the Type field and in the Cloud Provider field, choose Azure (Microsoft Azure) as shown in the image below.
Fill in the fields, as instructed below:
In the "Billing Connector Identification" field, enter the name that will identify the Data Connector (in this case, we will use Billing Focus Azure).
In the "Secret for this billing connector" field, select the secret created in the previous step (Azure Focus).
In the "Region" field, we will leave it as default.
In the "Name of the Storage that contains the billing data" field, add the information obtained on step 40.
Then, in the "Path that contains the billing information" field, enter the path as indicated on step 40.
To finish and create the Data Connector, click Save, as illustrated in the image on the side.
The FOCUS AZURE Billing connector is ready and configured.
Last updated