Overview
The Task Monitor task monitors another task or tasks for one or more specific statuses.
When setting up a Task Monitor task, you can monitor:
- All tasks
- Specific task
- Task type, such as a Windows task
- Group of tasks based on the name, such as all tasks whose name contains the string DEV
You also can monitor for any combination of task statuses.
For example, you can monitor for:
- All tasks with a status of RESOURCE WAIT or UNDELIVERABLE
- All Windows tasks in a FAILED status
- All tasks whose name contains REPORT that have a status of SUCCESS.
For Task Monitors within a workflow, you can also specify a Time Scope, or window of time, during which the event being monitored for must be satisfied.
Built-In Variables
The following built-in variables can be used in a Task Monitor task to pass data where appropriate:
Processing Flow for Task Monitors
The processing on a Task Monitor may differ depending on which of the following methods was used to launch it:
- Launched by a workflow
- Launched by a Task Monitor trigger
- Launched manually or by another trigger
Each method is described in detail below.
Note
Any changes made to a Task Monitor task are not recognized by its respective Triggers until those Triggers are disabled and re-enabled.
Launching a Task Monitor Task Within a Workflow
Within a Workflow, the Task Monitor task launches like any other task in the Workflow; that is, whenever the Workflow conditions warrant it. The Task Monitor runs until one of the conditions described below occurs:
- When the conditions specified in the Task Monitor are met, the Task Monitor goes to a status of SUCCESS.
- When the time window specified in the Task Monitor passes and the conditions in the Task Monitor are not met, the Task Monitor goes to a status of FAILED. If the time window is entirely in the past and Universal Controller does not locate the required event in the Activity table when the Task Monitor launches, the Task Monitor goes immediately to a FAILED status.
- If no time window is specified in the Task Monitor and the Task Monitor conditions are not met, the Task Monitor task continues running.
- A user can manually force finish the Task Monitor task.
The following diagram illustrates how a Task Monitor might go to SUCCESS and FAILED status within a workflow.
Launching a Task Monitor Task Using a Task Monitor Trigger
The Task Monitor task launches when the user enables the Task Monitor trigger. Each time the conditions in the Task Monitor task are satisfied, the tasks specified in the trigger are launched. This process continues until a user disables the associated Task Monitor trigger.
The following diagram shows an example of how you might set up a task monitoring scheme using the Task Monitor task and Task Monitor trigger.
Launching a Task Monitor Task Manually or Via Other Trigger
If you manually launch a Task Monitor task or launch it using a trigger other than a Task Monitor trigger, such as a Time trigger, the task continues running until its specified conditions are met. When that occurs, the Task Monitor goes to SUCCESS. No other processing occurs unless you have configured notifications with the task or set up some other task(s) to launch based on the status of this task.
The Task Monitor runs until one of the conditions described below occurs:
- When the time window specified in the Task Monitor passes and the conditions in the Task Monitor are not met, the Task Monitor goes to a status of FAILED. If the time window is entirely in the past and the Controller does not locate the required event in the Activity table when the Task Monitor launches, the Task Monitor goes immediately to a FAILED status.
- If no time window is specified in the Task Monitor and the Task Monitor conditions are not met, the Task Monitor task continues running.
Creating a Task Monitor Task
Step 1 | From the Automation Center navigation pane, select Tasks > Task Monitor Tasks. The Task Monitor Tasks list displays a list of all currently defined Task Monitor tasks. |
|---|---|
Step 2 | Enter/select Details for a new Task Monitor task, using the field descriptions below as a guide.
To display more of the Details fields on the screen, you can either:
|
Step 3 | Click a Save button. The task is added to the database, and all buttons and tabs in the Task Details are enabled. |
Note
To open an existing record on the list, either:
- Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)
- Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.
- Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).
Task Monitor Task Details
The following Task Monitor Task Details is for an existing Task Monitor task.
Depending on the values that you enter / select for these fields, and whether or not the Task Monitor task has ever been launched, more (or less) fields may display. See the field descriptions, below, for a description of all fields that may display in the Task Monitor Task Details.
Task Monitor Task Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in the Task Monitor Task Details.
Field Name | Description |
|---|---|
General | This section contains general information about the task. |
Name | Unable to render {include} The included page could not be found. |
Version | Unable to render {include} The included page could not be found. |
Description | Unable to render {include} The included page could not be found. |
Member of Business Services | Unable to render {include} The included page could not be found. |
Resolve Name Immediately | Unable to render {include} The included page could not be found. |
Time Zone Preference | Unable to render {include} The included page could not be found. |
Hold on Start | Unable to render {include} The included page could not be found. |
Hold Reason | Unable to render {include} The included page could not be found. |
Virtual Resource Priority | Unable to render {include} The included page could not be found. |
Hold Resources on Failure | Unable to render {include} The included page could not be found. |
Monitor Details | This section contains assorted detailed information about the task. |
Status To Monitor | Status being monitored for. When the task being monitored goes to a status specified in this field, the associated trigger is satisfied and the tasks specified in the trigger launch. You can specify as many statuses as needed (see Task Statuses). |
Monitoring Type | Unable to render {include} The included page could not be found. |
Task to Monitor | Unable to render {include} The included page could not be found. |
Task Name Condition | Unable to render {include} The included page could not be found. |
Task Type to Monitor | Unable to render {include} The included page could not be found. |
Name Starts With | Required if Task Name Condition = Starts With; Character string at the start of the name of a task or tasks being monitored for. |
Name Contains | Required if Task Name Condition = Contains; Character string in the name of a task or tasks being monitored for. |
Name Ends With | Required if Task Name Condition = Ends With; Character string at the end of the name of a task or tasks being monitored for. |
Name Equals | Required if Task Name Condition = Equals; Character string equaling the name of a task or tasks being monitored for. |
Name Wildcard | Required if Task Name Condition = Wildcard; Character string equaling the name of a wildcard in a task or tasks being monitored for. |
Resolve Task Name Condition | If Monitoring Type = Generals Task(s) and Task Name Condition = Starts With, Contains, Ends With, or Equals; Specification (true or false) for whether or not to resolve at run time any variables in the task name of the task(s) being monitored. |
Workflow Name Condition | Unable to render {include} The included page could not be found. |
Workflow Name Equals | Optional if Workflow Name Condition = Equals; Exact name of a workflow or workflows containing the task being monitored for. If the field is blank, the Task Monitor will consider a Task Instance for a match only if the Task Instance is not contained within a workflow. |
Workflow Name Starts With | Required if Workflow Name Condition = Starts With; Character string at the start of the name of a workflow or workflows containing the task being monitored for. |
Workflow Name Contains | Required if Workflow Name Condition = Contains; Character string in the name of a workflow or workflows containing the task being monitored for. |
Workflow Name Ends With | Required if Workflow Name Condition = Ends With; Character string at the end of the name of a workflow or workflows containing the task being monitored for. |
Workflow Name Wildcard | Required if Workflow Name Condition = Ends With; Character string of a wildcard in the name of a workflow or workflows containing the task being monitored for. |
Time Scope | Used for Task Monitor tasks not associated with a trigger. The Time Scope fields are used to create a window during which the Task Monitor conditions must be met in order for the Task Monitor to be satisfied. Options:
The Time Scope window is always relative to the time that the Task Monitor launched. For example, if you put -01:00 in the From time field and 02:00 in the To time field, the window's begin time is one hour before the Task Monitor is launched and its end time is two hours after it is launched. Use Relative / Last Run if you want to match the most recent prior instance. Note For additional details, see Understanding Relative Time Scope, below. |
Expiration Action | Unable to render {include} The included page could not be found. |
From [+/-]hh:mm: | Unable to render {include} The included page could not be found. |
To [+/-]hh:mm: | Unable to render {include} The included page could not be found. |
Wait / Delay Options | This section contains specifications for waiting to start and/or delaying on start the task. |
Wait To Start | Unable to render {include} The included page could not be found. |
Wait Time | Unable to render {include} The included page could not be found. |
Wait Day Constraint | Unable to render {include} The included page could not be found. |
Wait Duration | Unable to render {include} The included page could not be found. |
Wait Duration In Seconds | Unable to render {include} The included page could not be found. |
Delay On Start | Unable to render {include} The included page could not be found. |
Delay Duration | Unable to render {include} The included page could not be found. |
Delay Duration In Seconds | Unable to render {include} The included page could not be found. |
Workflow Only | Unable to render {include} The included page could not be found. |
Time Options | This section contains time-related specifications for task instances of the task. |
Late Start | Unable to render {include} The included page could not be found. |
Late Start Type | Unable to render {include} The included page could not be found. |
Late Start Time | Unable to render {include} The included page could not be found. |
Late Start Day Constraint | Unable to render {include} The included page could not be found. |
Late Start Nth Amount | Unable to render {include} The included page could not be found. |
Late Start Duration | Unable to render {include} The included page could not be found. |
Late Finish | Unable to render {include} The included page could not be found. |
Late Finish Type | Unable to render {include} The included page could not be found. |
Late Finish Offset Type | Unable to render {include} The included page could not be found. |
Late Finish Percentage Offset ( + ) | Unable to render {include} The included page could not be found. |
Late Finish Duration Offset ( + ) | Unable to render {include} The included page could not be found. |
Late Finish Duration Offset Unit | Unable to render {include} The included page could not be found. |
Late Finish Time | Unable to render {include} The included page could not be found. |
Late Finish Day Constraint | Unable to render {include} The included page could not be found. |
Late Finish Nth Amount | Unable to render {include} The included page could not be found. |
Late Finish Duration | Unable to render {include} The included page could not be found. |
Early Finish | Unable to render {include} The included page could not be found. |
Early Finish Type | Unable to render {include} The included page could not be found. |
Early Finish Offset Type | Unable to render {include} The included page could not be found. |
Early Finish Percentage Offset ( - ) | Unable to render {include} The included page could not be found. |
Early Finish Duration Offset ( - ) | Unable to render {include} The included page could not be found. |
Early Finish Duration Offset Unit | Unable to render {include} The included page could not be found. |
Early Finish Time | Unable to render {include} The included page could not be found. |
Early Finish Day Constraint | Unable to render {include} The included page could not be found. |
Early Finish Nth Amount | Unable to render {include} The included page could not be found. |
Early Finish Duration | Unable to render {include} The included page could not be found. |
User Estimated Duration | Unable to render {include} The included page could not be found. |
Critical Path Options | This section contains Critical Path-related specifications for the task. |
CP Duration | Unable to render {include} The included page could not be found. |
CP Duration (Resolved) | Unable to render {include} The included page could not be found. |
CP Duration Unit | Unable to render {include} The included page could not be found. |
Workflow Execution Options | This section contains Execution Restriction specifications for the task if it is within a Workflow. |
Execution Restriction | Unable to render {include} The included page could not be found. |
Restriction Period | Unable to render {include} The included page could not be found. |
Before Date | Unable to render {include} The included page could not be found. |
Before Time | Unable to render {include} The included page could not be found. |
After Date | Unable to render {include} The included page could not be found. |
After Time | Unable to render {include} The included page could not be found. |
Date List | Unable to render {include} The included page could not be found. |
Statistics | This section contains time-related statistics for task instances of the task. |
| First Execution | Unable to render {include} The included page could not be found. |
Last Execution | Unable to render {include} The included page could not be found. |
Last Instance Duration | Unable to render {include} The included page could not be found. |
Lowest Instance Time | Unable to render {include} The included page could not be found. |
Average Instance Time | Unable to render {include} The included page could not be found. |
Highest Instance Time | Unable to render {include} The included page could not be found. |
Number of Instances | Unable to render {include} The included page could not be found. |
Metadata | This section contains Metadata information about this record. |
UUID | Universally Unique Identifier of this record. |
Updated By | Name of the user that last updated this record. |
Updated | Date and time that this record was last updated. |
Created By | Name of the user that created this record. |
Created | Date and time that this record was created. |
Buttons | This section identifies the buttons displayed above and below the Task Details that let you perform various actions. |
Save | Saves a new task record in the Controller database. |
Save & New | Saves a new record in the Controller database and redisplays empty Details so that you can create another new record. |
Save & View | Saves a new record in the Controller database and continues to display that record. |
New | Displays empty (except for default values) Details for creating a new task. |
Update | Unable to render {include} The included page could not be found. |
Launch Task | Unable to render {include} The included page could not be found. |
View Parents | Unable to render {include} The included page could not be found. |
Copy | Creates a copy of this task, which you are prompted to rename. |
Delete | Unable to render {include} The included page could not be found. Note You cannot delete a task if it is either:
|
Refresh | Refreshes any dynamic data displayed in the Details. |
Close | For pop-up view only; closes the pop-up view of this task. |
Tabs | This section identifies the tabs across the top of the Task Details that provide access to additional information about the task. |
Variables | Unable to render {include} The included page could not be found. |
Actions | Unable to render {include} The included page could not be found. |
Virtual Resources | Unable to render {include} The included page could not be found. |
Mutually Exclusive | Unable to render {include} The included page could not be found. |
Instances | Lists all instances of the task. |
Task Monitor Triggers | Unable to render {include} The included page could not be found. |
Triggers | Unable to render {include} The included page could not be found. |
Notes | Unable to render {include} The included page could not be found. |
Versions | Unable to render {include} The included page could not be found. |
Viewing a Task Monitor Task Instance
When a Task Monitor task is launched, the Controller creates a task instance record of that task.
A task instance contains detailed information about a single execution of that task.
You can access a task instance from:
- Instances tab on the Task Monitor Task Details for that task
- Activity Monitor
- Task Instances list
Task Monitor Task Instance Details
The following Task Monitor Task Instance Details contains information on the execution of the task shown in the Task Monitor Task Details.
Task Monitor Task Instance Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in Task Monitor Task Instance Details.
Field Name | Description |
|---|---|
General | This section contains general information about the task instance. |
Instance Name | Name of this task instance. |
Instance Number | Unable to render {include} The included page could not be found. |
Description | Unable to render {include} The included page could not be found. |
Member of Business Services | Unable to render {include} The included page could not be found. |
Task | Unable to render {include} The included page could not be found. |
| Source Version | Unable to render {include} The included page could not be found. |
Launch Source | Unable to render {include} The included page could not be found. |
Source Instance | Unable to render {include} The included page could not be found. |
Invoked by | Unable to render {include} The included page could not be found. |
Execution User | Unable to render {include} The included page could not be found. |
Calendar | Unable to render {include} The included page could not be found. |
Time Zone Preference | Unable to render {include} The included page could not be found. |
Virtual Resource Priority | Unable to render {include} The included page could not be found. |
Hold Resources on Failure | Unable to render {include} The included page could not be found. |
Status | This section contains information about the current status of the task instance. |
Status | Unable to render {include} The included page could not be found. |
Exit Code | Unable to render {include} The included page could not be found. |
Status Description | Unable to render {include} The included page could not be found. |
Operational Memo | Unable to render {include} The included page could not be found. |
Evaluation Time | Unable to render {include} The included page could not be found. |
Critical | Unable to render {include} The included page could not be found. |
Wait Until Time | Unable to render {include} The included page could not be found. |
Queued Time | Unable to render {include} The included page could not be found. |
Trigger Time | Unable to render {include} The included page could not be found. |
Launch Time | Unable to render {include} The included page could not be found. |
Start Time | Unable to render {include} The included page could not be found. |
End Time | Unable to render {include} The included page could not be found. |
Duration | Unable to render {include} The included page could not be found. |
Trigger | Trigger, if any, on whose behalf the Task Monitor task is monitoring other tasks. |
Task Instance Matched | Last task that matched the specifications of the task(s) being monitored. |
Monitor Details | This section contains assorted detailed information about the task instance. |
Status To Monitor | Status being monitored for. When the task being monitored goes to a status specified in this field, the associated trigger is satisfied and the tasks specified in the trigger launch. You can specify as many statuses as needed (see Task Statuses). |
Monitoring Type | Unable to render {include} The included page could not be found. |
Task to Monitor | Unable to render {include} The included page could not be found. |
Task Name Condition | Unable to render {include} The included page could not be found. |
Task Type to Monitor | Unable to render {include} The included page could not be found. |
Name Starts With | Required if Task Name Condition = Starts With; Character string at the start of the name of a task or tasks being monitored for. |
Name Contains | Required if Task Name Condition = Contains; Character string in the name of a task or tasks being monitored for. |
Name Ends With | Required if Task Name Condition = Ends With; Character string at the end of the name of a task or tasks being monitored for. |
Name Equals | Required if Task Name Condition = Equals; Character string equaling the name of a task or tasks being monitored for. |
Name Wildcard | Required if Task Name Condition = Wildcard; Character string equaling the name of a wildcard in a task or tasks being monitored for. |
Resolve Task Name Condition | If Monitoring Type = Generals Task(s) and Task Name Condition = Starts With, Contains, Ends With, or Equals; Specification (true or false) for whether or not to resolve at run time any variables in the task name of the task(s) being monitored. |
Workflow Name Condition | Unable to render {include} The included page could not be found. |
Workflow Name Equals | Optional if Workflow Name Condition = Equals; Exact name of a workflow or workflows containing the task being monitored for. If the field is blank, the Task Monitor will consider a Task Instance for a match only if the Task Instance is not contained within a workflow. |
Workflow Name Starts With | Required if Workflow Name Condition = Starts With; Character string at the start of the name of a workflow or workflows containing the task being monitored for. |
Workflow Name Contains | Required if Workflow Name Condition = Contains; Character string in the name of a workflow or workflows containing the task being monitored for. |
Workflow Name Ends With | Required if Workflow Name Condition = Ends With; Character string at the end of the name of a workflow or workflows containing the task being monitored for. |
Workflow Name Wildcard | Required if Workflow Name Condition = Ends With; Character string of a wildcard in the name of a workflow or workflows containing the task being monitored for. |
Time Scope | Used for Task Monitor tasks not associated with a trigger. The Time Scope fields are used to create a window during which the Task Monitor conditions must be met in order for the Task Monitor to be satisfied. Options:
The Time Scope window is always relative to the time that the Task Monitor launched. For example, if you put -01:00 in the From time field and 02:00 in the To time field, the window's begin time is one hour before the Task Monitor is launched and its end time is two hours after it is launched. Use Relative / Last Run if you want to match the most recent prior instance. Note For additional details, see Understanding Relative Time Scope, below. |
Expiration Action | Unable to render {include} The included page could not be found. |
From [+/-]hh:mm: | Unable to render {include} The included page could not be found. |
To [+/-]hh:mm: | Unable to render {include} The included page could not be found. |
Wait / Delay Options | This section contains specifications for waiting to start and/or delaying on start the task. |
Wait To Start | Unable to render {include} The included page could not be found. |
Wait Time | Unable to render {include} The included page could not be found. |
Wait Day Constraint | Unable to render {include} The included page could not be found. |
Wait Duration | Unable to render {include} The included page could not be found. |
Wait Duration In Seconds | Unable to render {include} The included page could not be found. |
Delay On Start | Unable to render {include} The included page could not be found. |
Delay Duration | Unable to render {include} The included page could not be found. |
Delay Duration In Seconds | Unable to render {include} The included page could not be found. |
Time Options | This section contains time-related specifications for the task instance. |
Late Start | Unable to render {include} The included page could not be found. |
Started Late | Unable to render {include} The included page could not be found. |
Late Start Type | Unable to render {include} The included page could not be found. |
Late Start Time | Unable to render {include} The included page could not be found. |
Late Start Day Constraint | Unable to render {include} The included page could not be found. |
Late Start Nth Amount | Unable to render {include} The included page could not be found. |
Late Start Duration | Unable to render {include} The included page could not be found. |
Computed Late Start Time | Unable to render {include} The included page could not be found. |
Late Finish | Unable to render {include} The included page could not be found. |
Finished Late | Unable to render {include} The included page could not be found. |
Late Finish Type | Unable to render {include} The included page could not be found. |
Late Finish Offset Type | Unable to render {include} The included page could not be found. |
Late Finish Percentage Offset ( + ) | Unable to render {include} The included page could not be found. |
Late Finish Duration Offset ( + ) | Unable to render {include} The included page could not be found. |
Late Finish Duration Offset Unit | Unable to render {include} The included page could not be found. |
Late Finish Time | Unable to render {include} The included page could not be found. |
Late Finish Day Constraint | Unable to render {include} The included page could not be found. |
Late Finish Nth Amount | Unable to render {include} The included page could not be found. |
Late Finish Duration | Unable to render {include} The included page could not be found. |
Computed Late Finish Time | Unable to render {include} The included page could not be found. |
Early Finish | Unable to render {include} The included page could not be found. |
Finished Early | Unable to render {include} The included page could not be found. |
Early Finish Type | Unable to render {include} The included page could not be found. |
Early Finish Offset Type | Unable to render {include} The included page could not be found. |
Early Finish Percentage Offset ( - ) | Unable to render {include} The included page could not be found. |
Early Finish Duration Offset ( - ) | Unable to render {include} The included page could not be found. |
Early Finish Duration Offset Unit | Unable to render {include} The included page could not be found. |
Early Finish Time | Unable to render {include} The included page could not be found. |
Early Finish Day Constraint | Unable to render {include} The included page could not be found. |
Early Finish Nth Amount | Unable to render {include} The included page could not be found. |
Early Finish Duration | Unable to render {include} The included page could not be found. |
User Estimated Duration | Unable to render {include} The included page could not be found. |
Projected Late | Unable to render {include} The included page could not be found. |
Critical Path Options | This section contains Critical Path-related specifications for the task. |
CP Duration | Unable to render {include} The included page could not be found. |
CP Duration (Resolved) | Unable to render {include} The included page could not be found. |
CP Duration Unit | Unable to render {include} The included page could not be found. |
Workflow Execution Options | This section contains Execution Restriction specifications for the task if it is within a Workflow. |
Execution Restriction | Unable to render {include} The included page could not be found. |
Restriction Period | Unable to render {include} The included page could not be found. |
Before Date | Unable to render {include} The included page could not be found. |
Before Time | Unable to render {include} The included page could not be found. |
After Date | Unable to render {include} The included page could not be found. |
After Time | Unable to render {include} The included page could not be found. |
Date List | Unable to render {include} The included page could not be found. |
Statistics | This section contains time-related statistics for the task instance. |
User Estimated End Time | Unable to render {include} The included page could not be found. |
Lowest Estimated End Time | Unable to render {include} The included page could not be found. |
Average Estimated End Time | Unable to render {include} The included page could not be found. |
Highest Estimated End Time | Unable to render {include} The included page could not be found. |
Projected End Time | System-supplied; projected end time of the task instance, calculated by the Controller based on the projected end time of its predecessor (or the maximum projected end time of all its predecessors, if more than one path exists to that task instance) plus its estimated critical path duration. |
Metadata | This section contains Metadata information about this record. |
UUID | Universally Unique Identifier of this record. |
Updated By | Name of the user that last updated this record. |
Updated | Date and time that this record was last updated. |
Created By | Name of the user that created this record. |
Created | Date and time that this record was created. |
Status History | History of all statuses that the task instance has gone through. |
Buttons | This section identifies the buttons displayed above and below the Task Instance Details that let you perform various actions. |
Update | Unable to render {include} The included page could not be found. |
Force Finish | Unable to render {include} The included page could not be found. |
Hold | Unable to render {include} The included page could not be found. |
Skip | Unable to render {include} The included page could not be found. |
Re-run | Unable to render {include} The included page could not be found. |
View Parent | Unable to render {include} The included page could not be found. |
Delete | Unable to render {include} The included page could not be found. |
View Potential Matches | Unable to render {include} The included page could not be found. |
Refresh | Refreshes any dynamic data displayed in the Details. |
Close | For pop-up view only; closes the pop-up view of this task instance. |
Delete | Unable to render {include} The included page could not be found. |
Tabs | This section identifies the tabs across the top of the Task Instance Details that provide access to additional information about the task instance. |
Virtual Resources | Unable to render {include} The included page could not be found. |
Exclusive Requests | Unable to render {include} The included page could not be found. |
Notes | Unable to render {include} The included page could not be found. |
Viewing Potential Matches for a Running Task Monitor Task Instance
To view a list of running task instances that have the potential to match the specifications for tasks being monitored by the running Task Monitor task instance:
Step 1 | Either:
|
|---|---|
Step 2 | On the View Potential Matches pop-up dialog, select a date and click Submit. |
Step 3 | A list of all potential matches displays in a new tab. |
Step 4 | Click Print to print a hard copy of the list or Refresh to refresh the task instances on the list. |
Monitoring Task Execution
You can monitor all system activity from the Activity Monitor and can view activity history from the History list.
Understanding Relative Time Scope
For any relative Time Scope conditions within the past, a Task Monitor will analyze only the current content of the database; specifically, by using the Status (ops_exec."status_code") and the State Changed Time (ops_exec."state_changed_time") to determine potential matches from the time window in the past.
Consider a Task Monitor instance monitoring for a Failed status within a time window in the past. If a potential task instance has a current status of Failed, the current State Changed Time will indicate when that task instance transitioned to the Failed status. When the Task Monitor instance runs, any task instance with a matching Status, and a State Changed Time within the time window in the past, can be considered for a match.
Note
The Task Monitor instance will consider only the current content (that is, current Status and current State Changed Time) of the All Task Instances (ops_exec) table when searching for qualifying task instances that match within a time window in the past.
Revisiting the example above, if you had a task instance with a status of Failed within the time window in the past, but prior to the Task Monitor instance running, the task instance was Finished, it would no longer be considered for a match.
Be aware that when specified, the Time Scope is relative to the time that the Task Monitor instance runs.
For example, consider the following Task Monitor instance:
Field | Value |
|---|---|
Start Time | 2017-11-02 15:05:00 -0400 |
From [+/-]hh:mm | -6:00 |
To [+/-]hh:mm | -2:00 |
Status To Monitor | Success |
Task To Monitor | Sleep 0 |
For the relative Time Scope specified above, with a time window in the past, this would translate into the following query, paying particular attention to how the relative times are computed.
SELECT * FROM ops_exec WHERE "state_changed_time" >= '2017-11-02 09:05:00 -0400' AND "state_changed_time" <= '2017-11-02 13:05:00 -0400' AND "status_code" = '200' AND "task_id" = '410d6c0bc0a801c901838d8ac43b3279'