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. Click All Clients and from the drop-down list, select a client.

  2. Go to Setup > Integrations and Apps. If apps are already installed, the INSTALLED APPS page is displayed, else the AVAILABLE APPS page is displayed.

  3. Search for Azure app using the search option. You can also use the All Categories dropdown and select the appropriate public cloud category.

  4. Click ADD. The Add Azure page is displayed.

  5. Provide the details in the fields:

    • Name: Provide a suitable name for the integration.
    • Subscription ID: Enter the subscription ID.
    • Enter the Tenant ID, Client ID and Secret key.
    • Environment: Choose Azure.

  6. Click NEXT.

    In the Filter page:

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

  8. 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.

  9. Click NEXT.

  10. 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.

  11. 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.

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

  13. Click FINISH. The Azure app is installed.

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

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