Db2 Service Test

This test monitors the availability and response time of each database on the target DB2 UDB server.

Target of the test : A DB2 database server

Agent deploying the test : An external/remote agent; if you are running this test using the external agent on the eG manager box, then make sure that this external agent is able to communicate with the port on which the target DB2 server is listening. Alternatively, you can deploy the external agent that will be running this test on a host that can access the port on which the target DB2 server is listening. In case of the agentless approach, the remote agent used to monitor the DB2 DPF server should be deployed on a remote Windows host in the environment.

Outputs of the test : One set of results for each database instance on the target DB2 database server being monitored

Configurable parameters for the test
Parameter Description

Test period

How often should the test be executed

Host

The IP address of the DB2 server

Port
  • The port number through which the DB2 server communicates. The default port is 50000.
    		•

    User

    Specify the name of the user who is authorized to access the target database server and collect the required metrics in this text box. You can create a separate user on the OS hosting the DB2 server for this purpose. The steps for the same are detailed in the Creating a Special User for Monitoring DB2 Server topic.

    Password

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

    Confirm Password

    Confirm the Password by retyping it in the Confirm Password text box.

    Database

    Specify the name of the database on the monitored DB2 server to be used by this test.

    Query
  • The test emulates a user executing a query on the specified Database, and thus determines the availability and responsiveness of the database server. In the Query text box, specify the select query to execute.

    • Additional Databases

    By default, this parameter is set to none. This implies that the test will report the availability and responsiveness of the database specified against the Database parameter. If you wish to monitor the availability and responsiveness of other databases in the target DB2 server, then, you can specify those databases as a comma-separated list against this parameter. This will ensure that the availability and responsiveness of the specified databases will be reported by this test apart from the database specified against the Database parameter. The databases specified will be the descriptors of this test in this case.

    SSL

    If the target database server is SSL-enabled, then set the SSL flag to Yes. If not, then set the SSL flag to No.

    Trust Store File Name

    This parameter is applicable only if the target DB2 UDB database is SSL-enabled, if not, set this parameter to none. Specify the file name of the client-side SSL truststore that contains the server certificate required for establishing an SSL connection. The truststore is used to verify the identity of the server and enable a secure communication channel.

    By default, the truststore file should be placed in:<EG_INSTALL_DIR>/jre/lib/security/mytruststore.jks

    Here, mytruststore.jks is the Truststore file name. You may change this to any valid file name. By default, none is specified against this text box.

    Trust Store Password

    This parameter is applicable only if the target DB2 UDB database is SSL-enabled, if not, set this parameter to none. If a Truststore File name is provided, then, in this text box, provide the password that is used to obtain the associated certificate details from the Truststore File. By default, this parameter is set to none.

    Confirm Password

    Confirm the Password by retyping it in the Confirm Password text box.

    DD Frequency

    Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD frequency.

    Detailed Diagnosis

    To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

    The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

    • The eG manager license should allow the detailed diagnosis capability
    • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
    Measurements made by the test:
    Measurement Description Measurement Unit Interpretation

    Availability

    Indicates the availability of this database.

    Percent

    The availability is 100% when the database is responding to a request and 0% when it is not. Availability problems may be caused by a misconfiguration/malfunctioning of the database server, or if the database has not been started.

    Response Time

    Indicates the time taken by this database to respond to a user query.

    Secs

    A sudden increase in response time is indicative of a bottleneck at the database server.