Skip to main content
Version: 1.11.0

Monitoring Source

The monitoring source is a fundamental element of the event management process. The main task of the Monitoring Source is to connect the API Endpoint that receives messages from the external monitoring system and the target message table via Data Import mechanism.

The monitoring source has the information about the following entities:

  • the specified monitoring system.
  • the data structure provided by the system.
tip

Role required: admin.

To create a monitoring source, complete the following steps:

  1. Navigate to Monitoring and Event Management → Configuration → New Monitoring Source.
  2. Follow the instructions given on the page.
  3. When all the steps are completed, click Finish.

Step 1. Monitoring source name​

You need to specify a unique monitoring source name. The name of the monitoring source will also be used in the title of the target table as follows: Name Target Messages.

Step 2. Data structure​

Specify the data structure that you want to get from the monitoring source. You can use one of the available fields to enter the data:

  • JSON – insert the data in JSON format. Use Latin letters, , "" _ : symbols, and [0...9] numbers. You cannot put numbers at the beginning of attribute names.
  • Attributes and keys – create attributes by entering them in the input field. Use Latin letters, the _ symbol, and [0...9] numbers. Attribute names can only begin with letters or the _ symbol.
note

You cannot create the same attributes.

When data is inserted in one of the fields, it is automatically transferred to the other field in the required format.

You can also edit and delete attributes. There are two ways to do so:

  • Click to edit or to delete an attribute in the Attributes and keys area.
  • Edit or delete data in the JSON area.

Select the attributes from the list on the right to use as composite keys.

note

You need to select at least one attribute from the list to use it as the composite key to go to the next step.

Composite key​

A composite key is a set of values of several attributes. These attributes are considered to be a unique identifier that precisely defines an object that the monitoring system sends a message about. It can be an attribute with an ID or a combination of many attributes.

The role of the composite key

  1. After receiving a message from the monitoring system, the system forms a composite key from the values of those attributes that are specified as the Composite Key in the Monitoring Source.
  2. The system checks the generated composite key of the message for uniqueness against the records in the Composite Keys table that have the corresponding Monitoring Source value.
  3. The system generates a new record in the Composite Keys table if the composite key of the message is unique.

Step 3. Columns of a target table​

In step 3, you need to create columns for the target table. To do so, complete the following steps:

  1. In the New column area, fill in the fields. See the Create Columns article to learn more about this process.
  2. Click Add.
  3. Repeat and create as many columns as you need.
  4. When all columns are created, click Next to go to the last step.

To change the values of the created column or delete it, complete the steps below:

  1. Click the title in the Added columns area. The form appears on the left. Make changes and click Save, or click Delete to delete the column.
  2. To close the form without any changes, click in the top right corner of the area.

Step 4. Field mapping​

Set the field mapping to define the correlation between the fields of the monitoring source and the fields of the target table.

To do so, complete the following steps:

  1. Click the element in one of the areas. The chosen element is highlighted.
  2. In the opposite area, click the corresponding element.

As a result, the formed pair is highlighted in green, a connecting line runs between the elements. The pair is sorted to the bottom of the element list.

To disconnect the elements, click .

Add, edit, and delete a script​

You can add a script to the connected field pair that takes the record object of the monitoring source as an argument and returns the value to put into the target table field.

To add a script, complete the following steps:

  1. Click to open the modal window.
  2. Enter the script using the SimpleOne Server-Side API.
  3. Click Add.

tip

When there is a script for a pair of fields, the icon becomes green .

To open the edit window with the script specified, click . Make changes and click Save, or click Delete to delete the script.

Results​

As a result:

  • The Monitoring Source record is created. The field values are populated automatically with the values specified during the setup.
  • The endpoint in the API Actions (sys_api_action) table is created. The endpoint link is generated, you can copy it by clicking .
  • The Import Source record is created. It contains the import text in JSON format inserted in step 2.
  • The Target Table is created. The table contains columns that were created in step 3.
  • The field mapping between the fields of the monitoring source and the target table is set.
  • According to the data import mechanism, an intermediate table and mapping rules are created.

For further setup, you need to create Monitoring Rules, Event Rules and Actions.

Receive messages​

To receive messages from external monitoring systems on the configured source endpoint, you need to::

  1. Set up a system user with the monitoring_message_creator or import_admin role.
  2. Log in as the user and use the s_user.accessToken() methods in the browser console or getAccessToken() in the server script to get the user's token. The lifetime of the token is limited (you can set the time in the user.token.ttl system property).
  3. When sending messages to the endpoint, use authorization by token.