Sending tracking definitions to Performance Data Warehouse

In order to track performance data, you need to send tracking definitions to the Performance Data Warehouse. Each time you update your tracking requirements in IBM® Process Designer, you must send the updated definitions to Performance Data Warehouse.

Before you begin

Note: The update tracking definition operation fails if the schema name used in Performance Data Warehouse database or the user name set in the corresponding datasource was changed after the Tracking Group tables were created

About this task

When developing on the Process Center Server, be sure to send definitions when you make changes. For process applications deployed in runtime environments, snapshot any changes and deploy the new snapshot to ensure that the data you want to collect is available in the runtime environment.

The method of sending tracking definitions varies depending on the type of server you are using.

Server	Description	How to send tracking definitions
Process Center Server	When you use autotracking, manually create or edit tracking groups, or perform any other task in the Designer in IBM Process Designer to capture performance data, you must send these tracking requirements to the Performance Data Warehouse if you plan to run your processes on the Process Center Server to test data tracking and reports. If IBM Business Monitor is installed, its tracking definitions (part of a monitor model) are updated when you use this menu item.	In Process Designer, click File > Update Tracking Definitions.
Process servers in runtime environments	When you deploy snapshots of process applications on process servers in runtime environments, all tracking definitions are automatically sent to the Performance Data Warehouse in the selected runtime environment. This ensures that your data is tracked as expected when instances of your processes are run in the runtime environment. If IBM Business Monitor is installed, its tracking definitions (part of a monitor model) are automatically updated as well.	There is no need to send tracking definitions unless a problem occurs during snapshot deployment. If a problem does occur, you can select the Update Tracking Definitions option for the snapshot in the Process Admin Console.

Server

Description

How to send tracking definitions

Process Center Server

When you use autotracking, manually create or edit tracking groups, or perform any other task in the Designer in IBM Process Designer to capture performance data, you must send these tracking requirements to the Performance Data Warehouse if you plan to run your processes on the Process Center Server to test data tracking and reports.

If IBM Business Monitor is installed, its tracking definitions (part of a monitor model) are updated when you use this menu item.

In Process Designer, click File > Update Tracking Definitions.

Process servers in runtime environments

When you deploy snapshots of process applications on process servers in runtime environments, all tracking definitions are automatically sent to the Performance Data Warehouse in the selected runtime environment. This ensures that your data is tracked as expected when instances of your processes are run in the runtime environment.

If IBM Business Monitor is installed, its tracking definitions (part of a monitor model) are automatically updated as well.

There is no need to send tracking definitions unless a problem occurs during snapshot deployment. If a problem does occur, you can select the Update Tracking Definitions option for the snapshot in the Process Admin Console.

Results

When you send tracking definitions, either directly or as part of a snapshot deployment, the Performance Data Warehouse establishes the structure in its database to hold the data that is generated by the Process Server when you run instances of your processes. In IBM BPM, these tracking requirements are called definitions because they establish the database schema in the Performance Data Warehouse to accommodate the tracked data generated by the Process Server.