System Monitor
From OpsWise Documentation Wiki
Contents |
Overview
The System Monitor task allows you to monitor a specific remote machine and check for diskspace. You might use this task to check for sufficient diskspace before running a task on it that requires a certain amount. In order for this task to execute, the remote machine must have an OpsWise agent running on it.
Creating a New System Monitor Task
- From the Navigation Pane, select System Monitors.
- From the trigger wizard, select New. OpsWise Automation Center displays the System Monitor screen.
- Using the field descriptions provided below as a guide, complete the fields as needed.
- Click the Submit button to save the record and return to the menu, or, right-click on the title bar and select Save to save the record and remain on the current display.
- If appropriate, repeat these steps for any additional tasks you want to add.
Shown below is a System Monitor screen. Task run statistics appear after the first time this task has been launched.
System Monitor Field Descriptions
The table below describes the fields, buttons, and tabs on the System Monitor task definition and task instance screens. Most fields appear on both screens; however they do not always appear at the same spot. In the latter case, the table provides a field description at the location found on the task definition screen. Some fields appear only on one of the screens. Field labels shown in bold appear only on the task instance screen and are labeled as such.
| Field Name | Description | |
|---|---|---|
| Task/Instance Name | Required. Name used within OpsWise Automation Center to identify this task. Up to 40 alphanumerics; variables supported. It is the user’s responsibility to develop a workable naming scheme for tasks. | |
| Invoked by | Task instance only; system-supplied. How the task instance was launched. Options:
Trigger: [Trigger Name] - The instance was launched by the named trigger. Workflow: [Workflow Name] - The instance was launched by the named workflow. Manually Launched - The instance was launched by a user. To identify the user who launched the instance: |
|
| Task | Task instance only; system-supplied. | |
| Execution User | Task instance only; system-supplied. | |
| Instance Reference Id | Task instance only; system-supplied. | |
| Credentials | Optional. The login credentials OpsWise Automation Center will use to access the remote machine. See Credentials. | |
| Credentials Variable | Optional. If enabled, the Credentials field (see above) converts from a reference field (where you browse and select a record) into a text field that allows you to enter a variable. Use the format: ${variable name}. The variable must be a supported type as described in Using Variables. | |
| Agent | Optional. The name of the agent running on the remote machine. If you do not specify an agent, you must specify an agent cluster (see below). | |
| Agent Cluster | Optional. You can specify an agent cluster in addition to or in place of a specific agent. An agent cluster is a group of agents. If you specify an agent cluster, the System Monitor uses the selection method specified in the agent cluster definition to determine which machine to monitor for the file. (You can monitor all agents in the cluster using the Cluster Broadcast field -- see the description below.) If you specify an agent and an agent cluster, OpsWise Automation Center first tries to monitor the specific agent. If the agent is not available, the system reverts to the agent cluster. See Configuring Agent Clusters for more information. | |
| Agent Variable | Optional. If enabled, the Agent field (see above) converts from a reference field (where you browse and select a record) into a text field that allows you to enter a variable. Use the format: ${variable name}. The variable must be a supported type as described in Using Variables. | |
| Agent Cluster Variable | Optional. If enabled, the Agent Cluster field (see above) converts from a reference field (where you browse and select a record) into a text field that allows you to enter a variable. Use the format: ${variable name}. The variable must be a supported type as described in Using Variables. | |
| Hold on Start | If enabled, when the task is launched it appears in the Activity display with a status of Held. The task runs when the user releases it. | |
| Cluster Broadcast | Optional. You can specify a Cluster Broadcast in addition to or in place of a specific agent and/or Agent Cluster. When you specify an agent cluster in the Cluster Broadcast field, the agent monitors all agents in the cluster. If you specify an agent and an agent cluster (either in this field or the Agent Cluster field) OpsWise Automation Center first tries to monitor the specific agent. If the agent is not available, the system reverts to the agent cluster. See Configuring Agent Clusters for more information. | |
| Summary | User-supplied description of this task. | |
| Status | Task instance only; system-supplied. See Task Status. | |
| Status Description | Task instance only; system-supplied. Provides additional information, if any, about the status of the task. | |
| Start Time | Task instance only; system-supplied. The time the task started. | |
| Duration | Task instance only; system-supplied. The amount of time the task took to run. | |
| End Time | Task instance only; system-supplied. The time the task completed. | |
| Member of Groups | User-defined. Allows you to select one or more Opswise groups that this task definition belongs to. Click on the lock icon to unlock the field and select groups. | |
| User-Estimated Duration | The estimated amount of time it should normally take to run this task. The value in this field is used by OpsWise Automation Center to calculate the User Estimated End Time when the task is launched. You can view this information by selecting the Task Instance record from the Activity screen. | |
| Monitor Type | The type of system status being monitored for. Options:
|
|
| Condition | Specifies whether you want to check for free diskspace greater than or less than the amount specified in the Resource Available field. | |
| Resource Available | Required. Used in conjunction with the By Scale field, enter a number indicating the amount of the resource you are checking for. For example, to check to see if the machine has at least one gigabyte of free diskspace, select Greater Than in the Condition field, type 1 in the Resource Available field, and select GB in the By Scale field. | |
| By Scale | Indicates the scale of the number you entered in the Resource Available field. Options: KB (kilobyte), MB (megabyte), GB (gigabyte). | |
| Actual Available | System-supplied. Used in conjunction with the By Scale field, indicates the amount of resource that was found to be available after the task ran. | |
| By Scale | System-supplied. Indicates the scale of the number in the Actual Available field. One of: KB (kilobyte), MB (megabyte), GB (gigabyte). | |
| Mount Points or Drives | Required. Use this field to limit the check to a specific mount point or drive, such as drive C: for Windows. | |
| User Estimated End Time | Task instance only; system-supplied. | |
| Shortest Estimated End Time | Task instance only; system-supplied. | |
| Average Estimated End Time | Task instance only; system-supplied. | |
| Longest Estimated End Time | Task instance only; system-supplied. | |
| First Time Ran | System-supplied. Displays after task has been run. The date and time this task first ran. | |
| Lowest Instance Time | System-supplied. Displays after task has been run. The shortest amount of time this task has taken to run. | |
| Last Time Ran | System-supplied. Displays after task has been run. The last date and time the task ran. | |
| Average Instance Time | System-supplied. Displays after task has been run. The average amount of time this task takes to run. | |
| Number of Instances | System-supplied. Displays after task has been run. The number of times this task has run. | |
| Highest Instance Time | System-supplied. Displays after task has been run. The longest amount of time this task has taken to run. | |
| Last Instance Duration | System-supplied. Displays after task has been run. The amount of time the task took to run the last time it ran. | |
| Submit button | Submits the new record to the database. | |
| Update button | Saves updates to the record. | |
| Launch Task button | Manually launches the task. | |
| Delete button | Deletes the current record. | |
| Task Virtual Resources tab | Allows you to create virtual resource definitions for controlling access to resources by multiple tasks. See Creating Virtual Resources. | |
| Variables tab | Displays all variables associated with this task. | |
| Actions tab | Allows you to specify actions that the system will take automatically based on events that occur during the execution of this task. Events supported are task instance status, exit codes, late start, late finish, and early finish. Actions include:
|
|
| Task Instances tab | System-supplied. Displays a list of all instances generated by this task. | |
| Triggers tab | Displays a list of all System Resource Monitor triggers that have been defined to launch this task. Also allows you to add new triggers. For instructions, see Triggers. | |
| Notes tab | Displays all notes associated with this task. See Runbook Notes. | |
Specifying When a Task Runs
You can run the task as part of a workflow, specify triggers that run the task automatically based on times or events, or run the task manually.
Monitoring Task Execution
You can monitor all system activity from the Activity screen and can view activity history from the Activity History screen.
