Azure configuration

To install Microsoft Azure integration:

Step 1: Get Subscription ID

  1. Log in to the Azure portal.

  2. Click Subscriptions.

  3. From the list of subscriptions, click the subscription name.

  4. From the subscription details page, copy the Subscription ID on a text editor such as Notepad.

    You need Subscription ID to allow OpsRamp to collect cost analytics.

    Subscription ID

Step 2: Register an application in Azure Active Directory (AAD)

  1. Select Azure Active Directory.

  2. Check applicable permissions to create an application in Azure Active Directory. For instructions, see the Microsoft documentation on Check Azure Active Directory permissions.

  3. Register an AAD application.
    For instructions, see Register an application with Azure AD.

    OpsRamp supports OAuth 2.0 as an authentication method for App registration.

  4. Assign a role to the registered application. For instructions, see Assign a role to the application.

Click here to view detailed information on the different built-in roles, which you can select according to your requirements.

For details on a reader role, click here.

Step 3: Get Tenant ID, Client ID and secret key

  1. Select Azure Active Directory.

  2. On the left pane, click App Registrations.

  3. From the list of applications, click the application name.
    The details of the application is displayed.

  4. Copy the Client ID (Application ID) and save it to a text editor such as Notepad.

  5. Copy the Tenant ID (Directory ID) and save it to the text editor.

    Client ID & Tenant ID

    Client ID & Tenant ID

  6. On the left pane, click Certificates & secrets > New Client Secret. For details, refer to Create a Client secret.

  7. Enter the description, expiry time and click Add.
    The Client secret is displayed.

  8. Copy the value of the Client secret in a text editor. Copy the secret value and store it safely because you cannot retrieve it later.

You now have the subscription ID, Tenant ID, Client ID and Client secret key. Use these details to install Azure integration on the OpsRamp console.

OpsRamp configuration

After you have copied all the details from your Azure account, use the details to install Azure integration on the OpsRamp console.

To install Azure integration:

  1. Log in to the OpsRamp portal.

  2. Navigate to Setup > Account.

  3. On the ACCOUNT DETAILS page, select Integrations and Apps.

  4. The INSTALLED INTEGRATIONS page is displayed with all the installed applications.

    Note: If there are no installed applications, it will navigate to the AVAILABLE INTEGRATIONS AND APPS page.

  5. Click + ADD on the INSTALLED INTEGRATIONS page. The AVAILABLE INTEGRATIONS AND APPS page displays all the available applications along with the newly created application.
    Note: You can even search for the application using the search option available. Also, you can use the All Categories option to search.

  6. Click ADD.
    The ADD AZURE page is displayed.

  7. In the ADD AZURE page, enter the account information:

FunctionalityDescription
Name(required) Enter the name for the integration.
Type(required) Select the type (ARM or TENANT).
Subscription ID(required) Enter the subscription ID.
Tenant ID(required) Enter the Tenant ID generated during during Step 3: Get Tenant ID, Client ID and secret key.
Client ID(required) Enter the Client ID generated during during Step 3: Get Tenant ID, Client ID and secret key.
Security Key(required) Enter the security key you received during Step 3: Get Tenant ID, Client ID and secret key.
Environment(required) Choose the environment as AZURE.
  1. Click NEXT.

    In the Filter page:

  2. Choose Any or All to match any one or all of the defined conditions for filtering

  3. Select the options for the filter criteria:

    • Resource Type: List all the supported resource types.
    • Attribute Name: List attributes for the selected resource type. Attributes are resource type-dependent.
    • Logic condition: Logical match criteria for search: Contains, Not Contains, Equals, Not Equals, Starts With, Ends With, and Regex.
    • Value: Value corresponding to the attribute name and logical condition.

    Select the required resource types.

  4. Click NEXT.

  5. Select the actions to be performed on the resources.

    • Manage Device: Select this option such that all the discovered resources are in a managed state.
    • Collect Cost Analytics: Select this option to collect project cost details resources utilized.
    • Stream Azure Events: Provide Azure connection string-primary key. See instructions for configuring the connection string.
    • Assign Gateway Management Profile: Select a gateway management profile from the drop-down list.

  6. Click Install Agent (Linux only) if the agent needs to be installed on the device and select the device credentials.
    Select Agent Type as Direct or Proxy.
    If you select Proxy, then select a gateway management profile from the drop-down list.

  7. Select the Discovery Schedule option to schedule a discovery and define the preferred Recurrence pattern.

  8. Click FINISH. The Azure app is installed.

    All the discovered services are visible in the Infrastructure page under
    Resources > Azure

  9. Click Azure. The list of installed Azure integrations are displayed. You can perform actions like Edit, Uninstall, Rescan.

Enable Carbon Footprint action

When installing the Azure integration, you can enable Azure Carbon Footprint Action to monitor and optimize the carbon impact of your cloud resources. This feature provides insights into the carbon emissions of your Azure workloads and offers recommendations to improve sustainability. By enabling this option, you can track energy consumption, optimize resource usage, and contribute to reducing your organization’s environmental footprint while maintaining operational efficiency.

Steps to assign the Carbon Optimization Reader Role in Azure

  1. Navigate to the Azure Portal and search for Subscriptions.

  2. Click the subscription for which you want to collect carbon metrics.

  3. Navigate to Access Control (IAM) in the left menu and click Add role assignment.

  4. Under the Role section, select Carbon Optimization Reader.

  5. Click Next.

  6. In the Members section, click Select members, then choose the app that you previously registered (the one used to provide the client ID and secret in OpsRamp).

  7. Click Review + Assign to complete the role assignment for the selected subscription.

OpsRamp configuration

  1. Log in to the OpsRamp portal.

  2. Navigate to ADD AZURE page.

  3. In the ADD AZURE page, enter the account information. Select Type as ARM.

  4. Navigate to the FILTER screen and select choose All resources or choose specific resources to discover from your AZURE account.

  5. Navigate to the OPTIONS screen and select Carbon FootPrint checkbox.

  6. Click FINISH.
    The integration is completed, and carbon footprint action is enabled.