Agents Administration - Tests
 

Default Parameters for IBMDb2WrkLdTest

At configured intervals, this test compares the usage levels and execution times of all queries that started running on each database in the last measurement period and identifies a ‘top query’ in each of the following categories - CPU usage, memory usage, disk activity, and execution time. The test then reports the resource usage and execution time of the top queries and promptly alerts administrators if any query consumes more resources or takes more time to execute than it should. In such a scenario, administrators can use the detailed diagnosis of this test to view the inefficient queries and proceed to optimize them to enhance server performance.

This page depicts the default parameters that need to be configured for the IBMDb2WrkLdTest.

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • For the eG agent to collect the required metrics from the target database server, the eG agent should be configured with the credentials of a user who has SELECT privilege on the MON_CURRENT_SQL administrative view. The MON_CURRENT_SQL administrative view returns key metrics that can be used to identify long running activities (activities that were submitted on all members of the database and have not yet been completed). To create such a user issue the following command at the DB2 prompt:

    CONNECT TO <dbname> USER <username> USING <password> grant select on SYSIBMADM.mon_current_sql to <username>;

    For example: CONNECT TO ProdDB USER eGMonitoring USING p@ssword123 grant select on SYSIBMADM.mon_current_sql to eGMonitoring;

    Here, ProdDB indicates the database name;

    eGMonitor indicates the username;

    p@ssword123 indicates the password of mentioned user;

    Specify the name of such a user in USER textbox.

  • Enter the password of the specified USER in the PASSWORD text box.

  • Confirm the PASSWORD by retyping it in the CONFIRM PASSWORD text box.

  • Specify the name of the database on the monitored DB2 server to be used by this test, in the DATABASE text box.

  • If the IBM Db2 UDB database server being monitored is SSL-enabled, then set the SSL flag to YES. If not, then set the SSL flag to NO.

  • By default, the detailed diagnosis of this test, if enabled, will report only the top-5 records. This is why, the DDCOUNT parameter is set to 5 by default. If you want to include more or less records in detailed diagnosis, then change the value of this parameter accordingly.

  • Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz*” and $port will be changed to “80” when configuring a test.