This documentation supports the 19.08 version of BMC Helix Multi-Cloud Service Management.

Enabling integration with Azure Monitor

Azure Monitor provides analytics and insights about your cloud and on-premises resources and applications by analyzing telemetry. Azure monitor allows you to configure alerts on multiple Azure resources such as metrics, search queries, log events, website availability and so on.

As a Multi-Cloud tenant administrator, you set up integration between BMC Helix Multi-Cloud Service Management and Azure Monitor to create incidents in Remedy ITSM based on the following Azure Alerts:

  • Metric alerts
  • Activity log alerts

Before you begin

Complete all pre-configuration tasks before you configure the Azure Monitor integration.

To select the integration option for Azure Monitor

You can use Multi-Cloud to configure features provided for different cloud service providers through its Quick Configuration Guide section.

  1. Launch BMC Helix Platform by using the URL provided in the email sent to you from BMC, and log in as an administrator.
  2. Select Workspace > Applications > Multi-Cloud Service Management from the list of applications.
  3. To launch BMC Helix Multi-Cloud Service Management, in the top-right corner of the page, click Visit Deployed Application.

    Multi-Cloud URL

    You can access BMC Helix Multi-Cloud Service Management directly by entering the URL https://hostName:portNumber/innovationsuite/index.html#/com.bmc.dsm.mcsm and logging in as a tenant administrator.

  4. To open the configuration page, click Settings.
  5. Select Start Here > Quick Configuration Guide.
    BMC Helix Multi-Cloud Service Management lists the features available to you.

6. For the notification feature, select Azure Alert to Remedy Incident under Notification .

The Configuration Links page displays a list of the common configurations, connectors, flows, and connector targets and processes that you need to configure as described in the next tasks.  

To map Azure Monitor alert data to Remedy ITSM or Smart IT

Configuring vendor data includes setting up a vendor organization and defining vendor mappings for the technology provider. The Configuration Links page provides links to both options.

Note

BMC recommends that you set up the vendor organizations before starting the BMC Helix Multi-Cloud Service Management configuration. For more information about adding vendor organizations, see Performing pre-configuration tasks.

  1. If you have not done so already, in the Configuration Links page, click Manage Vendor Organizations to create or modify a vendor organization.
  2. To add or update the vendor mapping, in the Configuration Links page, click Map Vendors .
  3. To open the Map New Vendor  page, in the Map Vendors screen, click .
  4. Enter a Description that makes it easy for you to identify the vendor metadata configuration.
  5. Select the Ticketing Technology Provider.
    The Ticketing Technology Provider is the application the vendor uses to manage tickets. For example, the Ticketing Technology Provider for Azure Monitor is Azure Alerts.
  6. Add or update the Instance name for the provider.
  7. Click Add Mapping .
    BMC Helix Multi-Cloud Service Management displays the default  Instance URL , and  Display Field Mapping .
  8. To add or delete values, click  { }  to open the JSON editor, and modify the field mappings.
    1. Display Field Mapping:  Map vendor ticket fields to the fields on the Smart IT console.
    2. Vendor Field Mapping: Modify the vendor mapping for both Metric type alerts and Activity Log type alerts in the Vendor Specific section.

Vendor Specific section for Activity Log type alerts

Vendor Specific section for Metrics type alerts

To configure connectors for Remedy ITSM, Multi-Cloud, and Azure Monitor

For each feature you selected, complete the following procedure for the connectors listed in the Configuration Links page.

  1. To navigate to BMC Helix Integration Service, in the Configuration Links page, click Configure connectors in Integration Studio under Required Common Configurations.
    You need to configure the connectors listed for each feature, in addition to the connectors listed under Required Common Configuration.

  2. To enter field values, select the connector such as, Remedy ITSM and click Configuration.
    You might need to click the arrow on the ribbon in the lower section of the screen to open the Configuration pane.

  3. To update the configuration defaults, enter the appropriate field values by referring to the corresponding connectors at the end of this section.
  4. To add details of the user account to be used to access the vendor application, click Accounts.

List of connectors and configuration values for integration with Azure Monitor


 Remedy ITSM

  • Configuration
    If you are integrating BMC Helix Multi-Cloud Service Management with an on-premises instance of Remedy ITSM, enter the following values:
FieldValue
Site Select the site that you created for Remedy.
AR serverEnter the name of your on-premises AR System server.
AR server portEnter the port number for your on-premises AR System server.
  • Account
    Add the account of a Remedy ITSM user who has permissions to view business service requests, and to update incidents, change, or problem requests.


 Multi-Cloud

  • Configuration
    During activation BMC configures the Multi-Cloud connector. Do not modify the default Multi-Cloud connector configuration.
  • Account
    BMC sets up the account for the Multi-Cloud connector.
    Click to re-authenticate your account after you change the password for your tenant administrator account in BMC Helix Innovation Studio.


 Azure Alerts

  • Configuration
    If you are integrating BMC Helix Multi-Cloud Service Management with Azure Monitor, enter the following values:

    FieldValue
    NameEnter a name for your connector configuration.
    DescriptionEnter a description for your connector configuration.
    SiteSelect the site required to establish a connection between Azure Monitor and Integration service. You can either use the default cloud site or create your own site.
    Number of instances
    WebHook Message TypeSelect Basic or Secure. Select the same type when creating actions on Azure alerts in Microsoft Azure.
    Azure Tenant IdRequired only when you use secure webhook method.
    Application IdRequired only when you use secure webhook method.
    Application ID URIRequired only when you use secure webhook method.


 SMTP Email

  • Configuration
    To send email notifications for errors, specify values for the following fields:
FieldValue
NameEnter a name for the connector configuration.
SiteSelect the appropriate site for your email server.
Connection typeSelect the type of connection for your email server.
  • Account
    Add an email account to use for sending error notifications.

To configure flows between Remedy ITSM, Multi-Cloud, and Azure Monitor

For each feature you selected, complete this procedure for the flows listed in the Configuration Links page.

  1. To navigate to BMC Helix Integration Service, in the Configuration Links page, click Configure flows in Integration Studio under Required Common Configurations.

    You need to configure the flows listed for each feature, in addition to the flows listed under Required Common Configuration.

  2. To open the flow template page, on the Catalog tab in Integration Studio, click the flow you want to configure.

     Click here to view the image

  3. To create a copy of the flow template, click .

    To update the name of the flow that you have copied from the flow template, select My Flow, open the flow that you have copied and update the title.
  4. Select the appropriate accounts for the end-point connectors of the selected flow.
    You specify the connector accounts when configuring connectors.
  5. Specify the trigger Conditions and Field mapping, and click OK.
    For more information about trigger conditions and field mappings, see the list of flows in the Configuring flows section.

  6. Click My Flows and select the flow that you had created from the flow template.
  7. Click Details in the right pane to verify the target values for the trigger conditions and the field mappings.

List of flows and configuration values for integration with Azure Monitor

The out-of-the-box flow settings are based on common field mappings. You can update the trigger conditions or field mappings.


 Create Incident from Azure Alerts
  • Trigger 
    • Set Alert Type to Metric, Log, or Activity Log.
  • Field Mapping
    • Do not change the following default field mappings:
      • Summary: Monitoring Service, Monitor Condition and so on
      • Priority: Severity
      • Description: description
      • Urgency: Severity
      • Incident Type: User Service Restoration
      • Vendor Ticket Id: Short Alert Id
 Send Error Notification

  • Trigger
    Ensure that Flow Target is set to Multi-Cloud.

  • Field mappings
    • In the To field, enter the email account that will receive the error notification.
    • The following out-of-the-box field mappings can be modified; however, BMC recommends that you retain the default values.
      • Subject
      • From

To define connector targets to enable integration with Azure Monitor

BMC preconfigures the out-of-the-box Connector Targets for all BMC Helix Multi-Cloud Service Management features. If you want to update the connector configuration or account information, update the Connector Target for the feature.

Warning

Do not delete the out-of-the-box Connector Targets.

  1. To navigate to BMC Helix Platform, in the Configuration Links page, click Configure Connector Targets in Innovation Studio under Required Common Configurations .
    You need to configure the Connector Targets listed for each feature on the Configuration Links page, in addition to the ones listed under Required Common Configuration.
  2. Click the Connector Target you want to configure or click to configure a new Connector Target.
  3. Enter or update the following values and save the configuration.

    FieldDescription
    NameEnter a unique name for the configuration. This name is associated to the process related to the connector you are configuring.
    Connector Type

    Select the connector type from the list. The connectors available to you in BMC Helix Integration Service are provided in the list.

    Configuration

    Based on the connector type selected, the configuration defined for that connector in BMC Helix Integration Studio are listed. Select a configuration from the list.

    ProfileSelect the profile defined for the selected configuration.
  4. You must complete this procedure for all the connector targets listed in the Configuration Links page.

List of connector targets for integration with Azure Monitor


 MCSM Remedy ITSM

For the MCSM Remedy ITSM Connector Target, define the connection configuration and profile required by the connector process.

To configure Azure Alerts webhooks

  1. Log in to Integration Studio.
  2. Search for the Create Incident from Azure Alerts flow.
  3. Copy the WebHook URL value from the flow by clicking the Flow in Use button.
  4. To add a webhook to an action, follow the instructions for a basic webhook or a secure webhook. 
  • To configure a basic webhook, perform the following steps:
    1. In the Webhook panel, set Secure webhook to No.
    2. Paste the WebHook URL from step 3 to URI.
    3. Set Common Alert Schema to Yes.
    4. The following image shows a sample webhook action. 
  • To configure a secure webhook, perform the following steps:
    1. If you have not registered the app, register the app here .
      After you have registered your app, you can find the Object ID in the Overview tab. You will also need Application ID and Tenant ID for configuration in the Azure Alerts connector.
    2. In the Overview tab, copy Object ID of your registered app.
    3. In the Webhook panel, set Secure webhook to Yes.
    4. Paste the Object ID that you copied from the registered app.
    5. Paste the WebHook URL from step 3 to URI.
    6. Set Common Alert Schema to Yes.
      The following image shows a sample webhook action

For more details about Azure Monitor, please see this link .


When you complete the configuration for all the components, verify that incidents are created in Remedy ITSM based on different Azure Alerts such as Metric alerts and Activity log alerts.

Related topic

Configuring BMC Helix Multi-Cloud Service Management

Was this page helpful? Yes No Submitting... Thank you

Comments