Agents Administration - Tests
 

Configuration of ATowerJobTplTest

This test auto-discovers the job templates in each project in the Ansible Tower, and reports the total number of jobs that was launched using each job template in a particular project. In the process, this test reports the status of a job that ran last in each project and time taken for each job to complete. This enables administrators to identify a job template that causes more job failures and find out if any of the jobs took longer than usual to complete. In addition, this test alerts administrators to the number of hosts and groups that failed during jobs execution using each job template. These statistics help administrators to find out where the real problem (i.e. is it with job template or with host/group?) lies and resolve the same quickly.

The default parameters associated with this test are as follows:

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed. By default this is set to 5 minutes.

  • In the HOST text box, the host for which the test is to be configured has to be specified.

  • In the PORT text box, enter the port number at which the target host being monitored listens. By default this is set to NULL

  • The eG agent makes REST API calls for pulling out performance metrics from the Ansible Tower. For this purpose, the eG agent should be allowed to connect to Ansible Tower's REST API. To enable this connection, administrators need to configure the valid credentials of a user who has administrator privileges on the Ansible Tower against these parameters in USERNAME and PASSWORD text boxes.

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

  • By default, the Ansible Tower is SSL-enabled. Accordingly, the SSL flag is set to True by default. This indicates that the eG agent will communicate with the Ansible Tower via HTTPS, by default.

  • Specify the comma-separated list of projects that you want the eG agent to exclude from monitoring against this parameter. By default, EXCLUDED PROJECTS is set to &rldquo;none” indicating that this test will monitor all the projects in the Ansible tower.

  • Specify the comma-separated list of Job Templates that you want the eG agent to exclude from monitoring in this text box. By default, EXCLUDED JOB TEMPLATES is set to &rldquo;none” indicating that this test will monitor all the Job Templates in the Ansible tower.

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

  • To make diagnosis more efficient and accurate, eG 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, by default, for a particular server, choose the On option against DETAILED DIAGNOSIS. 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 bad and normal 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 necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of “none” in the parameter value indicates that the corresponding parameter value can be changed if required.