Introduction

Email alerts integration allows you to configure parsing conditions and create an alert within OpsRamp once the conditions are met.

This document provides instructions on setting up Email Alerts integration in OpsRamp, how to configure the parsing conditions, and steps to validate the conditions.

Configure integration

Follow these steps to configure Email Alerts integration:

  1. Click All Clients, select a client.

  2. Click Setup > Account.

  3. Select the Integrations tile.

  4. The Installed Integrations screen is displayed, with all the installed applications. Click + ADD on the Installed Integrations page.

  5. If you do not have any installed applications, you will be navigated to the Available Integrations page. The Available Integrations page displays all the available applications along with the newly created application with the version.
    Note: Search for the application using the search option available. Alternatively, use the All Categories option to search.

  6. Click +ADD on the Email Alerts tile.

    Email Alerts - Configuration screen

  7. Enter the following information in the Configuration screen:

    Table Note

    CONFIGURE

    Field NameField TypeDescription
    NameStringEnter a unique name for the integration.
    Alert SourceDropdownSelect Email Alerts from the dropdown.

  8. Click NEXT. The SETUP screen is displayed.

    Email Alerts - Setup screen

  9. Enter the following information in the SETUP screen:

    BASIC DETAILS

    Field NameField TypeDescription
    Integration email addressStringAny email sent to this email address will be parsed with the parsing conditions and an alert is created in OpsRamp.
    Make a note of the Email address.

    PARSING CONDITIONS: Provide Email parsing conditions to create an alert.

    1. Select the PARSING CONDITIONS checkbox and click +ADD.
    Email Alerts - Add parsing condition screen

    1. Enter the following information in the ADD PARSING CONDITION window: Note: If Service Name or Device Host Name does not match, Unknown will be assigned as default value.

      Field NameField TypeDescription
      Set as defaultCheckboxSelect this option if you want to set the Parsing Rule Name and RULE as default. This will be set as default if the other conditions that you configure are not met.
      Parsing Rule NameStringProvide a name for the parsing rule.
      ALERT STATEDropdownSelect source and condition from the dropdown lists and enter value(s) in the box(es).
      Select Priority from the dropdown.
      If the condition is not met, the priority is considered.
      To configure map attributes, click +MAP and enter the Third-party Property Value and OpsRamp Property Value.
      DEVICE HOST NAMEDropdownSelect source and condition from the dropdown lists and enter value(s) in the box(es).
      SERVICE NAMEDropdownSelect source and condition from the dropdown lists and enter value(s) in the box(es).
      To add more conditions, click +ADD.
      To configure map attributes, click +MAP and enter the Third-party Property Value and OpsRamp Property Value.
      DATE FORMATStringProvide the date format.

      Provide conditions for the following attributes:
      RULE, ALERT TIME, ALERT TYPE, COMPONENT, DESCRIPTION, DEVICE IP ADDRESS, and SUBJECT.

    2. Click ADD PARSING CONDITION. The parsing condition is added and displayed in the PARSING CONDITIONS section.
      You can add multiple parsing conditions.

    VALIDATE: To validate the parsing conditions:

    1. Select parsing rule name checkbox and click VALIDATE.
      The VALIDATION dialog box is displayed.

      Parsing condition validation screen

    2. Enter Sample subject and Sample content.

    3. Click VALIDATE. Based on the parsing conditions given, the values are returned.

      • To edit the parsing condition, click the three dots (menu) icon and select Edit.
      • You have to add at least two conditions in order to remove a parsing condition.

    ADDITIONAL SETTINGS: You can configure the integration to post alerts only if the resources are managed by OpsRamp. For resources that are not managed, the events are dropped and not processed.

    • Select the Drop alerts from unmanaged resources checkbox as needed.

  10. Click FINISH. The integration is installed and listed under Installed Integrations.

Next steps

  • Create an alert using email:
    1. Compose an email with alert subject and alert content.
    2. Send the email to the copied incoming email address. OpsRamp processes the alert content with the parsing conditions and creates an alert. The alert created is displayed on the Alerts page.

Actions on Integration

You can perform actions like View Logs, Export, Edit, Assign Templates, and Uninstall on the integration.

Audit Logs

View Inbound logs from the View Logs option for the integration. You can view if the event was successful or not.

See Audit Logs for more information.