eG Administration
 

Configuring Measures for a Custom Test

A Custom test type offers a user the complete flexibility in introducing new monitoring functionality. To implement a Custom test, a test class is generated using a Test Generator API to perform the specific functions expected of the test. Using a Custom test type, you can build both performance and configuration tests.

A major step in incorporating a new Custom test into eG Enterprise is to inform eG Enterprise about the number and types of measurements that will be made by the test. To configure the measures that are to be reported by the test, click the Measure tab in the NEW TEST DETAILS page. To add a new measure, click the Add New Measure button. In the NEW MEASURE DETAILS pop up window, specify the following:

  • The Measure index determines the order in which the measures are to be displayed in the monitor console. For example, if you select 1 as the Measure index then the corresponding measure will appear first in the list of measures displayed in the monitor console. Note that the same Measure index should not be assigned to two different measures of a particular test.

  • The Measure name field indicates the name of the measurement (this will be displayed in the eG monitor interface).

  • The Database column size field indicates the size of each database record corresponding to a measurement value. For example, Number(7,4) indicates that the output of the measurement will be a number in the range 0 to 100, with the fractional value being limited to four decimal places.

  • The Unit (whether %, seconds, requests/sec, etc.) specifies the unit in which the measurement's value is reported. The required unit can be selected from the options available in the list box.

  • Sometimes, administrators may want to convert the unit of measurement of a performance metric before displaying the same in the eG monitoring console. For instance, a duration value originally available in ‘milliseconds’ may have to be changed to ‘Secs’ before it is displayed in the console. If you want the unit of the measure being added to be so converted at test run time, then select a Conversion Factor from the list. For example, if a value in ‘milliseconds’ needs to be converted to ‘seconds’, then select /1000 as the conversion factor. By default, 1 is chosen as the Conversion Factor; this implies that, by default, unit conversion does not take place for a new measure at test run time.

    Note:

    The Conversion Factor list comes with a default set of conversion factors. You can however, override this list by adding more conversion factors. For instance, the default Conversion Factor list does not provide the option to convert Bytes to MB at run time. To include this option in the list, follow the steps below:

    • Edit the eg_ui.ini file in the <EG_INSTALL_DIR>\manager\config directory.
    • To include a new conversion factor, you will have to append an entry of the following format to the [CONVERSION_FACTORS] section of the file:
      DisplayName=Value
    • For instance, to support ‘Bytes to MB’ conversion, append the following entry to the [CONVERSION_FACTORS] section:
      /1048576 (Bytes to MB)=0.00000095367431640625
    • In this case, the DisplayName, /1048576 (Bytes to MB), will be displayed as an option in the Conversion Factor drop-down list. If this option is chosen, then, at test run time, the conversion value of 0.00000095367431640625 will be multiplied with the actual measure value that is reported in Bytes to convert it into MB. Care should be taken while specifying the conversion value, as incorrect values will result in wrong measures being reported by the test.
    • Once the new entry is appended to the [CONVERSION_FACTORS] section, save the file.
    • Finally, restart the manager.

    Once this is done, you will find the string /1048576 (Bytes to MB) appear as an option in the Conversion Factor list.

  • In the Alarm display string text box, specify the text string that must be displayed in the eG alarm window when the corresponding measurement violates its threshold.

  • Click the Add button, to add the measurement. Upon clicking the Add button, the ADD MEASURE TO TEST pop up window will then appear. Click Yes in this pop up window if you would like to add more measures for this test. This will once again open the NEW MEASURE DETAILS pop up window, using which you can configure the second measure. If you do not wish to add any more measures, click the No button.

The newly added measure will then be listed in this page. To delete a measure, you can click the Delete button availabe in each measure section.

To modify a measure, click the Modify button.