Monitoring and maintaining system data

To prevent performance issues, periodically monitor and purge your Process and Performance Data Warehouse databases of data that is no longer required.

Monitoring system data

You can monitor key process-related artifacts that can impact performance by using the following functions in Process Admin Console:
System Maintenance Status
View aggregated status that displays the number of artifact instances for several artifact types to ensure that the amount of data is below system capacity. The system tracks by default artifact types such as processes, named snapshots, unnamed snapshots, tasks, and durable messages. The thresholds that are set for an artifact type are intended to define the number of instances that can accumulate without impacting performance. For each artifact type, the system notifies you with SystemOut.log file messages when the number exceeds the established thresholds. To customize the threshold settings, see Configuring notifications and actions for system maintenance.

To view the status, log in to the Process Admin Console, and click the System Maintenance Status tab.

Performance Dashboard
View detailed information for the processes and other artifacts that affect the health of your system. For more information, see Discovering and managing database performance issues by using the Performance Dashboard.

To access the dashboard, log in to the Process Admin Console. In the Server Admin area of the console, click Performance > Performance Dashboard.

Maintaining system data

An administrator can purge unneeded data by using the Process Admin Console, Business Automation Workflow operations REST API, or wsadmin commands.
Important: All calls to the Business Automation Workflow operations REST API require that the HTTP header BPMCSRFToken is set with every request. For information about how to obtain a token, see Preventing cross site request forgery.
Tip: Removing process applications and toolkits also deletes related process and task instance data.

The following table enumerates the Process Admin Console functions, REST API, and wsadmin commands to maintain the key artifacts. For additional guidance on maintaining the system, see Managing persisted data and Purging data in IBM Business Process Manager.

Table 1. Purging options for the maintenance of process instances, task instances, snapshots, and durable messages
Artifact type Process Admin Console REST API wsadmin commands
Process instances Workflow Admin > Health Management

See Deleting process instances

See Deleting process instances
IBM® Workflow Server
BPMProcessInstancesPurge command

BPMDeleteSnapshot command also purges related process data.

IBM Workflow Center
The following wsadmin commands purge related process data.
Tasks
  • Workflow Admin > Task Cleanup
  • Workflow Admin > Health Management
See Deleting tasks and associated data and attachments from the database
Not available
Workflow Server
BPMTasksCleanup wsadmin command
The following wsadmin commands also purge related task data.
Workflow Center
BPMTasksCleanup wsadmin command
The following wsadmin commands also purge related task data.
Named snapshots Workflow Admin > Health Management

See Deleting snapshots

See Deleting snapshots
Workflow Server
BPMDeleteSnapshot command
Workflow Center
BPMSnapshotCleanup wsadmin command
The following wsadmin commands also purge related snapshot data.

See also BPMShowOrphanedToolkits wsadmin command

Unnamed snapshots Workflow Admin > Health Management

See Deleting snapshots

Not applicable to Workflow Server
See Deleting snapshots

Not applicable to Workflow Server

Workflow Server
Not applicable
Workflow Center
BPMSnapshotCleanup wsadmin command
Durable messages Not available Not available
Workflow Server
BPMDeleteDurableMessages command
Workflow Center
BPMDeleteDurableMessages command