To create a monitoring source, complete the steps below:
- Navigate to Monitoring and Event Management → Configuration → Monitoring Sources.
- Click New.
- Follow the instructions given on the page.
- Once all 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
You need to specify the data structure that you want to get from the monitoring source. You can use one of the available fields to enter data:
- JSON – insert data in JSON format. Use Latin letters and {} , "" _ symbols.
Attributes and keys – create attributes by entering them in the input field. Use Latin letters and the _ symbol.
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.
Select the attributes from the list on the right that will be used as composite keys.
You need to select at least one attribute from the list that will be used as composite keys to go to the next step.
Step 3. Columns of the target table
In step 3 you need to create columns for the target table. To do this, complete the following steps:
- In the New column area, fill in the fields.
- Click Add.
- Repeat and create as many columns as you need.
- When all columns are created, click Next to go to the last step.
| Field | Mandatory | Description |
|---|---|---|
| Column type | Y | Specify a column type. The column type specifies the type of the data stored. Depending on the type selected, additional fields may appear on the form (see below). For more information, refer to the Column Types article. |
| Title | Y | Specify a column title displayed on the form. It should be meaningful and human-readable. You can use Latin or Cyrillic letters, [0..9] numbers, and the underscore symbol ( _ ). |
| Column name | Y | System column name. This field is populated automatically, depending on the title entered. Latin letters, [0..9] numbers, and the underscore symbol ( _ ) are allowed. |
| Reference | Y | Specify a dictionary with the values you need. The field appears when the List or Reference option is selected in the Column type field. |
| Choice table | N | Reference to a table with options. The field appears when the Choice option is selected in the Column type field. |
| Choice type | Y | Define whether the None option is applicable for the field. Available options:
If the Dropdown without --None-- is chosen, the Default value field becomes mandatory. The field appears when the Choice option is selected in the Column type field. |
| Default value | Y/N | Specify a default value that will be populated automatically to the field when a new record is created. The field appears when the Choice option is selected in the Column type field. It becomes mandatory when the Dropdown without --None-- (specify a default value) type is chosen. |
| Choice options | N | Create choice options for the column. Click
The field appears when the Choice option is selected in the Column type field. |
To change the values of the created column or delete it, complete the steps below:
- Click on its title in the Added columns area. The form will appear on the left.
- Make changes and click Save, or click Delete to delete the column.
- To close the form without any changes, click
in the top right corner of the area.
- To close the form without any changes, click
Step 4. Field mapping
This step is optional. To finish the monitoring source setup, click Finish.
Set the field mapping to define the correlation between fields of the monitoring source and fields of the target table.
To do this, complete the following steps:
- Click the element in one of the areas. The chosen element is highlighted.
- 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 a script
You can add a script to the connected field pair so that the record object of the monitoring source is taken as an argument and returns the value to put into the target table field.
To add a script, click 
.
Enter the script using SimpleOne Server-Side API.
Use the transformEntry() function with the following parameters available:
- source – the Import Set Row record that will be transformed. Call a specific field from the record just like a regular SimpleRecord object. For example, source.imp_name.
- target – the record in the target table that will be inserted or updated within the transformation of the source record. Call a specific field from the record just like a regular SimpleRecord object. For example, target.name = source.imp_name.
