Enabling/Disabling Statistic Collection
Statistic collection is controlled differently for process engine statistics and activity statistics. Statistic collection for process instances is controlled by a custom engine property. Statistic collection for activities is controlled dynamically while the process engine is running.
Collecting statistics on a per process instance or activity basis affects the performance of the process engine. Extra processing and I/O is required for gathering and writing the statistics to a file.
Collecting statistics on an activity basis is especially resource intensive. It is recommended that you collect activity statistics for brief periods of time while determining the performance requirements of a system or while tuning an application. It is not recommended that you continuously run activity statistic collection on a production system.
Process Instance Statistic Collection
Process instance statistic collection is controlled by the custom engine property bw.engine.jobstats.enable
. The default value of this property is false
indicating that statistics for each process instance should not be stored. Setting this property to true
enables the gathering of statistics for each process instance.
For more information about custom engine properties, see Custom Engine Properties.
Activity Statistic Collection
You can enable or disable activity statistic collection using either TIBCO Administrator or TIBCO Hawk commands. This section describes the TIBCO Administrator approach. For more information about TIBCO Hawk commands, see Performance Tuning.
To control activity statistic collection, perform the following procedure:
Procedure
1. | Under Application Management, select All Service Instances or go directly to a specific application and select All Service Instances. |
2. | Click a process engine name. |
3. | Click the Engine Control tab. |
4. | In the Statistics Collection pane, click the Start button to begin statistics gathering for activities or click the Stop button to halt statistics gathering. The current status of statistic gathering is detailed in the Status field. If statistics gathering is disabled, the Status is Off. If statistics gathering is enabled, the Status field details the location of the file containing activity statistics. |
java.property.bw.activity.output.stats.elapsedTime.
activty_name
in designer.tra
for design-time and bwengine.tra
for runtime. Setting this property causes a performance overhead and hence it is recommended that you use this property in a non-production environment as a diagnostic tool. You can turn off the property and not calculate the elapsed time at run-time by setting the property java.property.bw.activity.output.stats.elapsedTime.turnoff
in the bwengine.tra
file. For more information, see TIBCO ActiveMatrix BusinessWorks™ Palette Reference.