Configuration of DockImgPerfTest

This test monitors the images of the Docker server and reports the number of containers created using each image. By analyzing the number of running containers created from each image and the resource utilization of those containers, administrators can figure out the image that is widely used by the users to create the containers and analyze how well the resources are utilized by those containers.

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.

• Specify the host for which the test is to be configured in the HOST text box.

• Provide port number at which the specified HOST listens. The default is 2375.

• By default, the USESUDO flag is set to Yes indicating either of the following:

  • The eG agent is using the sudo commands to collect the required metrics from the target docker server if monitored in an agent based manner or

  • The target docker server is monitored in an agentless manner and the eG agent install user is within a docker group.

  If the target docker server is monitored in an agentless manner and the user privileges are altered in the /etc/sudoers file, then, set this flag to No.

• Specify the credentials of the user who is authorized to execute the docker commands on the target server in the DOCKER USER and DOCKER PASSWORD text boxes.

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

• By default, the Docker server listens on 2375. This implies that while monitoring a Docker server via an SSL-enabled environment, the eG agent, by default, connects to port 2375 of the Docker server to pull out metrics. In some environments however, this default port may not apply. In such a case, against the WEBPORT parameter, you can specify the exact port at which the Docker server in your environment listens so that the eG agent communicates with that port.

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