Configuration of CorOSContinerStTest

This test reports the total count of containers launched using the target CRIO container engine. In addition, this test reports the count of containers that are currently running/added/removed/paused. This test also sheds light on those containers that were not started for a long time and those containers that were running for a longer duration. The detailed diagnosis of this test helps administrators figure out the exact name of the containers that are running/added/removed/paused.

The default parameters associated with this test are:

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

• In the HOST text box, specify the HOST for which this test is to be configured.

• In the PORT text box, specify the port at which the target host is listening. The default is 2379.

• By default, USE SUDO flag is set to No. This indicates that, by default, this test will report the metrics by executing the crictl command. However, in some highly secure environments, the eG agent installed user may not have the permissions to execute this command directly. In such cases, do the following:

  • Edit the SUDOERS file on the target host and append an entry of the following format to it:

    <eG_agent_install_user> ALL=(ALL) NOPASSWD:<Command>

    For instance, if the eG agent install user is eguser, then the entries in the sudoers file should be:

    eguser ALL=(ALL) NOPASSWD: crictl

  • Finally, save the file.

  • Then, when configuring the test using the eG admin interface, set this parameter to Yes. This will enable the eG agent to execute the sudo crictl command and retrieve the relevant metrics for this test.

• Specify the number of days beyond which a container should be classified as a long running container in the LONG RUN CONTAINER DAYS text box. By default, this is set to 6 days.

• By default, SHOW TOTAL CONTAINERS IN DD flag is set to No indicating that by default, the test does not generate detailed measures for the Total containers measure, so as to conserve storage space. However, if you want the test to generate and store detailed measures for the Total containers measure, set this flag to Yes.

• By default, SHOW STOPPED CONTAINERS IN DD flag is set to No indicating that by default, the test does not generate detailed measures for the Exited containers measure, so as to conserve storage space. However, if you want the test to generate and store detailed measures for the Exited containers measure, set this flag to Yes.

• For this test to report the numerical statistics of the containers that were not started/running, set a valid value against TIME LIMIT IN WEEKS parameter. For example, if you wish to report the containers that were not started for more than 5 weeks, then set 5 against this text box. By default, this parameter is set to 4 indicating that this test will report the containers that were not started for more than 4 weeks.

• 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 button will appear in this page. Clicking on this button 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.