Agents Administration - Tests
 

Default Parameters for VCEventsTest

The VCEventsTest enables administrators to promptly capture and report the count and details of critical information, error, warning, and user events that are generated on the vCenter server.

This page depicts the default parameters that need to be configured for the VCEventsTest.

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

  • In the VC USER and VC PASSWORD text boxes, you need to specify the name and password of a user with Administrator or Virtual Machine Administrator privileges to vCenter. However, if, owing to security constraints, you are not able to use the credentials of such a user for test configuration, then you can configure this test with the credentials of a user with Read-only rights to vCenter. For this purpose, you can assign the ‘Read-only’ role to a local/domain user to vCenter, and then specify name and password of this user against the VC USER and VC PASSWORD text boxes.

    vCenter servers terminate user sessions based on timeout periods. The default timeout period is 30 mins. When you stop an agent, sessions currently in use by the agent will remain open for this timeout period until vCenter times out the session. If the agent is restarted within the timeout period, it will open a new set of sessions. If you want the eG agent to close already existing sessions on vCenter before it opens new sessions, then, instead of the ‘Read-only’ user, you can optionally configure the VC USER and VC PASSWORD parameters with the credentials of a user with permissions to View and Terminate Sessions on vCenter. For this purpose, you can create a special role on vCenter, grant the View and Terminate Sessions privilege to this role, and then assign the new role to a local/domain user to vCenter.

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

  • By default, SHOWALLEVENTS flag is set to Yes. This implies that the test, in addition to reporting metrics for configured event categories, will also report metrics for an All descriptor. Typically, the measures reported by the All descriptor will be the aggregate of the measures reported by all the other descriptors of this test - i.e., every measure reported by the All descriptor will actually return the sum of the values that all configured events have registered for that measure. This enables administrators to easily assess the overall performance of events configured for monitoring on a vCenter server.

  • Set the SHOWALLONLY flag to Yes, if you wish to view only the consolidated metrics of all the events of this test. This indicates that the All descriptor will alone be listed for this test. By default, this flag is set to No.
  • By default, the vCenter server is SSL-enabled. Accordingly, the SSL flag is set to Yes by default. This indicates that the eG agent will communicate with the vCenter server via HTTPS by default.

  • By default, in most virtualized environments, vCenter listens on port 80 (if not SSL-enabeld) or on port 443 (if SSL-enabled) only. This implies that while monitoring vCenter, the eG agent, by default, connects to port 80 or 443, depending upon the SSL-enabled status of vCenter - i.e., if vCenter is not SSL-enabled (i.e., if the SSL flag above is set to No), then the eG agent connects to vCenter using port 80 by default, and if vCenter is SSL-enabled ((i.e., if the SSL flag is set to Yes), then the agent-vCenter communication occurs via port 443 by default. Accordingly, the WEBPORT parameter is set to default by default.

    In some environments however, the default ports 80 or 443 might not apply. In such a case, against the WEBPORT parameter, you can specify the exact port at which vCenter in your environment listens, so that the eG agent communicates with that port for collecting metrics from vCenter.

  • Typically, if the DETAILED DIAGNOSIS flag is set to On for this test, then periodically, eG Enterprise collects the complete details of all the information, error, warning, and user events generated on vCenter, and stores them in the database. This way, whenever a user clicks on the DIAGNOSIS icon (magnifying glass icon) corresponding to any of the measures reported by this test in the monitoring console, eG Enterprise retrieves the relevant detailed diagnosis information from the database and provides it to the user. In large virtualized environments however, the number of information events generated on the vCenter server will be quite huge. Naturally, the detailed diagnosis of such events will also occupy a considerable amount of database space, which will only grow with time. In order to minimize the strain on the eG database, by default, the detailed diagnosis capability for the information events alone is turned off in the eG Enterprise system. .Accordingly, the SHOW INFORMATION DD flag is set to No by default. However, this flag can be set to Yes, so that detailed diagnosis is available for information events as well.

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