4.24 Tasks

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.

4.24.1 Resource Objects

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)

4.24.2 Default Schedule

The default interval for this script is Asynchronous. After you start the Knowledge Script, its job status appears as Running.

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