Tasks

A task can be scheduled for repetitive execution on the server or on a connected collector. Arbitrary execution schedules can be defined and shared between different tasks and monitors. On execution, a task gets a set of configuration parameter values, and after execution the task provides an execution status containing data about the execution.

AppMon provides built-in tasks to automate repeating tasks like generating reports or storing sessions.

Configuration

You can create tasks through the System Profile or the Tasks and Monitors dashlet:

  • In the System Profile Preferences dialog box, select Tasks and then click Create.
  • In the Tasks and Monitors dashlet, right-click and select Create from the context menu.

When creating a task through the dashlet, you must first select a System Profile and specify that you are creating a Task.

Select System Profile for new task
Select System Profile for new task

When you click the Create button in the System Profile Preferences dialog box or click OK in the Add Task/Monitor dialog box, the Task Type Chooser appears.

Task type chooser
Task type chooser

Select the type, then click OK to display the Scheduled Task Editor.

For each task type, the you must enter a unique Name and optionally a Description. The other settings are specific to the task type. These settings are described below in Task Types.

On the Schedule tab, define the task schedule and select the execution target.

Select whether the task should be run manually or run on a schedule.

If you select Run scheduled:

  • Select the interval from the first list. The selections range from Every 10 Seconds through Every Hour.
  • Click Add to use a preconfigured schedule or define new schedule, or click Edit to revise the schedule. For further information on schedules, see System Profile - Schedules.
  • Optionally select Business Hours from the second list. For further information on Business Hours, see System Profile - Business Hours.

In the Execute on list, select the AppMon Server or an available Collector.

Scheduled task editor
Scheduled task editor

Task types

This section describes the configuration options for the different task types.

Memory snapshot

The Memory Snapshot task creates a Memory Snapshot for a specified Agent.

Memory Snapshot Task Configuration
Memory Snapshot Task Configuration
Parameter Name Description
Agent Group To make sure the Agent Group name is entered correctly, click Pick Agent to select an Agent Group or Agent through the Agent Browser.
Agent Mapping In the Agent Browser, you can select an Agent Group name or an Agent Mapping. If you select an Agent, the Agent Group is entered in the Agent Group field and the Agent Mapping is entered in this field. If you select an Agent Group, this field remains blank.
Agent Host The Agent's host name.
Agent Process Id The Agent's process ID.
Agent Instance Name A regular expression defining the instance name for the Agent.
Type Select one of the snapshot types:
  • Trending Memory Snapshot
  • Leak Analysis Memory Snapshot
  • Selective Memory Snapshot
See Memory Diagnostics for information about the different snapshot types.
Lock session to prevent deletion Select this option to prevent the session from being deleted during automated cleanups on low disk space.
Force Garbage Collection before creating snapshot Force a Garbage Collector run before creating the Memory Snapshot.
Capture values of String objects Include String values in the Memory Snapshot. This setting is only available for Leak Analysis Snapshots. It requires Java 6 or CLR 2.0.
Capture values of primitive fields Include primitive field values in the Memory Snapshot. This setting is only available for Leak Analysis Snapshots. It requires Java 6 or CLR 2.0.
Automatically post-process memory snapshot Enable or disable automatic post-processing after creating the dump.

Sampling

The Sampling task captures samples of all stacks of a specified Agent.

Sampling Task Configuration
Sampling Task Configuration
Parameter Name Description
Agent Group To make sure the Agent Group name is entered correctly, click Pick Agent to select an Agent Group or Agent through the Agent Browser.
Agent Mapping In the Agent Browser, you can select an Agent Group name or an Agent Mapping. If you select an Agent, the Agent Group is entered in the Agent Group field and the Agent Mapping is entered in this field. If you select an Agent Group, this field remains blank.
Agent Host The Agent's host name.
Agent Process Id The Agent's process ID.
Agent Instance Name A regular expression defining the instance name for the Agent.
Rate Move the slider to select a sampling rate from Lowest (every 1,000 milliseconds = 1 second) to Highest (every 10 milliseconds). The default is every 50 milliseconds. Higher sampling rates produce more accurate results but cause higher overhead.
Duration The duration in seconds for how long the sampling should run. The default is 60 seconds.
Lock session to prevent deletion Select this option to prevent the session from being deleted during automated cleanups on low disk space.

Session recording

The Session Recording Task starts session recording for a specified live session.

Session Recording Task Configuration
Session Recording Task Configuration
Parameter Name Description
Name Name for the recorded session file.
Automatically append timestamp Select this option to append a timestamp file name.
Description Description for the recorded session.
Duration (minutes) How many minutes to continue recording the session.
Lock Session Select this option to prevent the session from being deleted during automated cleanups on low disk space.
Recording options Select the information to be stored in the session: PurePath and time series, Only PurePaths marked as violated and time series, only Time series.
Session labels Specify the labels that to assign to the created session. Clicking the Value field opens the Edit Session Labels dialog box through which you can create New labels and Delete labels.

Thread dump

The Thread Dump Task performs a thread dump for a specified Agent.

Thread Dump Task Configuration
Thread Dump Task Configuration
Parameter Name Description
Agent Group To make sure the Agent Group name is entered correctly, click Pick Agent to select an Agent Group or Agent through the Agent Browser.
Agent Mapping In the Agent Browser, you can select an Agent Group name or an Agent Mapping. If you select an Agent, the Agent Group is entered in the Agent Group field and the Agent Mapping is entered in this field. If you select an Agent Group, this field remains blank.
Agent Host The Agent's host name.
Agent Process Id The Agent's process ID.
Lock session to prevent deletion Select this option to prevent the session from being deleted during automated cleanups on low disk space.