4.9 Events

Use this Knowledge Script to monitor events reported by vCenter Server, such as when a user powers off a virtual machine. You can filter the events by vCenter entity type, user name, and event description.

This Knowledge Script raises an event based on these filters. Use the Objects tab to define the resources you want to monitor. This script monitors all error and warning type events by default.

A list of VirtualCenter_Events events with the same short event message will not display individual event details. By default, AppManager collapses event details based on the object and the short event message. If the short event message is the same for a series of events, the list of events will collapse. To view the individual event details, disable event collapsing for that specific Events job.

WARNING:This Knowledge Script can potentially raise an excessive number of AppManager events, as well as unassociated events for objects not discovered in the AppManager TreeView pane. Use the filtering parameters in this script, such as event description and entity type, to limit the number of events monitored by the script and prevent a flood of irrelevant vCenter events.

Each event report shows the following information:

  • Target

  • Category

  • Description

  • User name

  • Time on the vCenter Server when the event occurred

NOTE:The first time you run this script, you may experience a short delay before actual monitoring begins. This delay is caused by the various initialization processes that must be carried out by the Events script.

4.9.1 Resource Objects

Run the Discovery_VirtualCenter Knowledge Script on the objects you want to monitor before running this Knowledge Script. You can also monitor objects that the Discovery_VirtualCenter Knowledge Script does not discover, such as distributed virtual port groups and distributed virtual switches.

You can run this script on the following resource objects:

  • vCenter server

  • Clusters

  • Datacenters

  • Datastores (you cannot monitor folders under the Datastore object)

  • Hosts

  • Resource pools

  • Virtual appliances (vApps)

  • Virtual machines

  • Folders (you can only monitor the folder objects found under the Host & Clusters parent folder in the TreeView pane)

  • Distributed virtual port groups (not displayed in the TreeView pane)

  • Distributed virtual switches (not displayed in the TreeView pane)

  • Network (not displayed in the TreeView pane)

  • VMware distributed virtual switch (not displayed in the TreeView pane)

4.9.2 Default Schedule

The default interval for this script is Asynchronous.

4.9.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

General Settings

Job Failure Notification

Event severity when AppManager failed to log in

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager failed to log in. The default is 5.

Event severity when Events job fails unexpectedly

Set the severity level, from 1 to 40, to indicate the importance of an event in which AppManager fails unexpectedly. The default is 5.

Event severity when filter settings contain conflicts

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the filter settings contain conflicts. The default is 15.

Additional Settings

Event Details

Event detail format

Select either HTML Table or Plain Text as the format for event detail. The default is HTML Table.

Monitor vCenter Events

Event Notification

Raise event if vCenter “error” event is detected?

Select Yes to raise an event if an “error” event is detected. The default is Yes.

Event severity if vCenter “error” event is detected

Set the severity level, from 1 to 40, to indicate the importance of an event in which a vCenter “error” is detected. The default is 5.

Select vCenter entity type(s)

Click Browse [...] to select the vCenter entity types you want to monitor. The default settings include these entity types: Cluster, Datacenter, Datastore, Folder, Host, ResourcePool, vApp, VirtualMachine.

NOTE:To monitor a datastore cluster object, select vCenter for this parameter.

User

If you want to raise events only for a specific user, provide the name of the vCenter user you want to monitor. If you do not enter a user name, AppManager raises events related to all users. This parameter is not case-sensitive.

The asterisk (*) and (?) are acceptable wildcards.

NOTE:You must enter at least a * for this script to run. Use the regular expression \s* to filter only empty values. Do not leave this parameter blank.

Event description

If you want to raise events that include specific text, provide text the event description must contain to be monitored. If you do not provide text, AppManager raises events regardless of text. This parameter is not case-sensitive.

The asterisk (*) and (?) are acceptable wildcards.

NOTE:You must enter at least a * for this script to run. Use the regular expression \s* to filter only empty values. Do not leave this parameter blank.

Raise event if vCenter “warning” event is detected?

Select Yes to raise an event if a vCenter “warning” event is detected. The default is Yes.

Event severity when vCenter “warning” event is detected

Set the severity level, from 1 to 40, to indicate the importance of an event in which a vCenter “warning” is detected. The default is 15.

Select vCenter entity type(s)

Click Browse [...] to select the vCenter entity types you want to monitor. The default settings include these entity types: Cluster, Datacenter, Datastore, Folder, Host, ResourcePool, vApp, VirtualMachine.

NOTE:To monitor a datastore cluster object, select vCenter for this parameter.

User

If you want to raise events only for a specific user, provide the name of the vCenter user you want to monitor. If you do not enter a user name, AppManager raises events related to all users. This parameter is not case-sensitive.

The asterisk (*) and (?) are acceptable wildcards.

NOTE:You must enter at least a * for this script to run. Use the regular expression \s* to filter only empty values. Do not leave this parameter blank.

Event description

If you want to raise events only that include specific text, provide text the event description must contain to be monitored. If you do not provide text, AppManager raises events regardless of text. This parameter is not case-sensitive.

The asterisk (*) and (?) are acceptable wildcards.

NOTE:You must enter at least a * for this script to run. Use the regular expression \s* to filter only empty values. Do not leave this parameter blank.

Raise event if vCenter “info” event is detected?

Select Yes to raise an event if a vCenter “info” event is detected. The default is unselected.

Event severity when vCenter “info” event is detected

Set the severity level, from 1 to 40, to indicate the importance of an event in which a vCenter “info” event is detected. The default is 25.

Select vCenter entity type

Click Browse [...] to select the vCenter entity types you want to monitor. The default settings include these entity types: Cluster, Datacenter, Datastore, Folder, Host, ResourcePool, vApp, VirtualMachine.

NOTE:To monitor a datastore cluster object, select vCenter for this parameter.

User

If you want to raise events only for a specific user, provide the name of the vCenter user you want to monitor. If you do not enter a user name, AppManager raises events related to all users. This parameter is not case-sensitive.

The asterisk (*) and (?) are acceptable wildcards.

NOTE:You must enter at least a * for this script to run. Use the regular expression \s* to filter only empty values. Do not leave this parameter blank.

Event description

If you want to raise events only that include specific text, provide text the event description must contain to be monitored. If you do not provide text, AppManager raises events regardless of text. This parameter is not case-sensitive.

The asterisk (*) and (?) are acceptable wildcards.

NOTE:You must enter at least a * for this script to run. Use the regular expression \s* to filter only empty values. Do not leave this parameter blank.

Data Collection

NOTE:This script can only collect data for those event categories for which you have selected Yes for the relevant Raise event for... parameter. For example, if you want to collect data for error events, you must select Yes for the Raise event if vCenter “error” event is detected? parameter.

Default time interval to collect data

Specify a default time interval for collecting data for charts and reports. The default is 5 minutes.

Collect data for error events?

Select Yes to collect data about error events for charts and reports. The default is Yes.

Collect data for warning events?

Select Yes to collect data about warning events for charts and reports. The default is unselected.

Collect data for info events?

Select Yes to collect data about informational events for charts and reports. The default is unselected.