System - Console Test

The Control Domain test discussed above reports the CPU and memory usage of the control domain. While this can indicate a contention for resources on the control domain, it cannot lead administrators to the exact process(es) executing on the domain that could be causing the contention. To enable administrators to accurately diagnose the root-cause of CPU or memory contentions experienced by the control domain, and to facilitate effective analysis of its impact on other parameters such as run queue length and swap memory usage, eG Enterprise offers the specialized System - Console test.

This test is disabled by default. To enable the test, go to the enable / disable tests page using the menu sequence : Agents -> Tests -> Enable/Disable, pick Oracle VM Manager as the desired Component type, set Performance as the Test type, choose the test from the disabled tests list, and click on the < button to move the test to the ENABLED TESTS list. Finally, click the Update button.

Target of the test : Oracle VM Manager

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the Oracle VM Server being monitored.

Configurable parameters for the test
Parameter Description

Test period

How often should the test be executed

Host

The host for which the test is to be configured.

Port

The port number at which the specified Host listens to. By default, this will be NULL.

Oracle VM Manager, Oracle VM Manager
User, Oracle VM Manager Password,
and Confirm Password

This test remotely connects to the Oracle VM Manager that manages the monitored Oracle VM Server and uses the web services API of the Oracle VM Manager to pull out metrics of interest. To enable this test to communicate with the web services API, you first need to configure the test with the IP address or host name of the Oracle VM Manager. This can be done using the Oracle VM Manager text box. Then, you need to configure the test with the credentials of a user with Admin rights to the Oracle VM Manager. Use the Oracle VM Manager User and Oracle VM Manager Password parameters to configure these credentials. Finally, confirm the password by retyping it in the Confirm Password text box.

SSL

By default, the Oracle VM Manager is SSL-enabled. Accordingly, the ssl flag is set to Yes by default. This indicates that the eG agent will communicate with the Oracle VM Manager via HTTPS by default.

WebPort

By default,, the Oracle VM Manager listens on 7002. This implies that while monitoring an Oracle VM server via an SSL-enabled Oracle VM Manager, the eG agent, by default, connects to port 7002 of the Oracle VM Manager 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 Oracle VM Manager in your environment listens so that the eG agent communicates with that port.

Detailed Diagnosis

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.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Virtual CPU utilization of console

This measurement indicates the percentage of utilization of the CPU time of the control domain.

Percent

A high value could signify a CPU bottleneck. The CPU utilization may be high because a few processes are consuming a lot of CPU, or because there are too many processes contending for a limited resource. The detailed diagnosis of this test reveals the top-10 CPU-intensive processes on the control domain.

System usage of CPU by console

Indicates the percentage of CPU time spent for system-level processing.

Percent

An unusually high value indicates a problem and may be due to too many system-level tasks executing simultaneously.

Run queue length of console

Indicates the instantaneous length of the queue in which threads are waiting for the processor cycle. This length does not include the threads that are currently being executed.

Number

A value consistently greater than 2 indicates that many processes could be simultaneously contending for the processor.

Blocked processes on console

Indicates the number of processes blocked for I/O, paging, etc.

Number

A high value could indicate an I/O problem on the console (e.g., a slow disk).

Swap memory of console

Denotes the committed amount of virtual memory. This corresponds to the space reserved for virtual memory on disk paging file(s).

MB

An unusually high value for the swap usage can indicate a memory bottleneck. Check the memory utilization of individual processes to figure out the process(es) that has (have) maximum memory consumption and look to tune their memory usages and allocations accordingly.

Free memory of console OS

Indicates the free memory available.

MB

A very low value of free memory is also an indication of high memory utilization. The detailed diagnosis of this measure lists the top 10 processes responsible for maximum memory consumption on the control domain.