Use this Knowledge Script to monitor a set of vCenter tasks. You can filter the tasks by vCenter entity type, task name, and task user name. This script raises an event when monitored task failures are detected. Use the Objects tab to define the resources you want to monitor.
A list of VirtualCenter_Tasks 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 Tasks job.
In some instances, a new vCenter task might not include data about the inventory entity associated with the task, such as the VM or the datastore. When this occurs, AppManager associates the task with the root vCenter object in the TreeView. To ensure that you receive events about vCenter tasks that do not contain inventory information, select vCenter for the Select vCenter entity type parameter.
Each event report shows the following information:
Task name
Target
User name
Time on the vCenter Server when the task completed
Error message
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 Tasks script.
Run the Discovery_VirtualCenter Knowledge Script on the vSphere components 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)
The default interval for this script is Asynchronous. After you start the Knowledge Script, its job status appears as Running.
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 Tasks job fails unexpectedly |
Set the event severity level, from 1 to 40, to indicate the importance of an event in which the Tasks job 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 Task Failures |
|
Event Notification |
|
Raise event if vCenter task fails? |
Select Yes to raise an event if a vCenter “error” event is detected. The default is Yes. |
Event severity when vCenter task fails |
Set the event severity level, from 1 to 40, to indicate the importance of an event in which a vCenter task fails. The default is 10. |
Select vCenter entity type |
Click Browse [...] to select the vCenter entity types you want to monitor. The default is all entity types: Cluster, Datacenter, Datastore, dvSwitchFolder, dvPortGroup, Folder, Host, Network, ResourcePool, vApp, vCenter, VirtualMachine, VMwaredvSwitch. 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, VirtualMachine. NOTE:To monitor a datastore cluster object, select vCenter for this parameter. |
Task user name |
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. Do not leave this parameter blank. |
Task name |
If you want to raise events only for a specific task, provide the name of the vCenter task you want to monitor. If you do not enter a task name, AppManager raises events related to all tasks. This parameter is not case-sensitive. The asterisk (*) and (?) are acceptable wildcards. NOTE:You must enter at least a * for this script to run. Do not leave this parameter blank. |