Agents Administration - Tests
 

Configuration of JenkinsQueueTest

This test monitors the queue in the Jenkins server, and reports ID of the queue where the jobs are being queued and the status of each job in the queue. This test also reveals if any job is being blocked/stuck (waiting for an executor) in the queue. These statistics help administrators to instantly identify the jobs that are being blocked/stuck or residing in the queue for a prolonged period and take necessary actions for the same.

The default parameters associated with this test are:

  • The TEST PERIOD list box helps the user to choose How often should the test be executed. By default, this is set to 30 minutes.

  • In the HOST text box, specify the IP address of the Jenkins server that is being monitored.

  • In the PORT text box, specify the port at which the specified host listens. By default, this is set to 8080.

  • Specify the valid credentials of a user who has Read-only access to the Jenkins REST API to gather performance metrics from the target Jenkins server against the USERNAME AND PASSWORD parameters.

  • Confirm the Password by retyping it in the CONFIRM PASSWORD textbox.

  • By default, the SSL flag is set to No, indicating that the target Microsoft SQL server is not SSL-enabled by default. To enable the test to connect to an SSL-enabled Microsoft SQL server, set the SSL flag to Yes.

  • Specify the comma-separated list of projects that you want the eG agent to exclude from monitoring against this parameter. By default, EXCLUDED JOB is set to none indicating that this test will monitor all the jobs running in the Jenkins server

  • The 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.

  • The DETAILED DIAGNOSIS makes diagnosis more efficient and accurate, the eG Enterprise suite 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

  • If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

  • Once the above values are provided, click on the UPDATE button to 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.