Create a connector definition

Create a connector definition to support a new external event source.

Before you begin

Write custom JavaScript code that accomplishes these actions:
  • Connect to an event monitoring tool.
  • Retrieve events from an event monitoring tool.
  • Send events to the Event [em_event] table using a web service API.
Role required: em_mgmt_operator, evt_mgmt_admin or evt_mgmt_integration

Procedure

  1. Navigate to Event Management > Connectors > Connector Definitions.
  2. Click New.
  3. In the Script type field, select Javascript.
  4. In the Javascript to run field, specify the required Javascript file.
  5. Fill in the fields, as appropriate.
    Table 1. Connector Definition form
    Field Description
    Name Mandatory. Event monitoring software that generated the event, such as SolarWinds or SCOM. This field has a maximum length of 100. It is formerly known as event_class.
    Script type Mandatory. Select the script type:
    • JavaScript
    • Groovy (deprecated)
    JavaScript to run Mandatory. Specify the file name of the JavaScript required for the event source.
    Default schedule Mandatory. The number of seconds between attempts to receive events.
    Bi-directional Specify to enable the external monitoring system to be updated if the alert is changed. There is default implementation for SCOM.
    Alert field identifier Mandatory. Specify the alert field that, if changed manually, causes the external monitoring system to be updated.
    Note: This field only appears if Bi-directional is selected.
    Connector Parameters Specify the parameters to enable communication with an event server.
    Connector Definition to MID Server Capabilities The MID server name to process events from the event server. If not specified, an available MID Server is used.
  6. Click Submit.