TIBCO Hawk Properties

TIBCO Administrator is the preferred monitoring and management tool for ActiveMatrix BusinessWorks. However, process engines have a TIBCO Hawk microagent as well. The properties in this section should be set only on deployed engines. These properties are not intended to be used with process engines started by TIBCO Designer for testing process definitions.

For more information about using TIBCO Hawk to monitor and ActiveMatrix BusinessWorks, see Performance Tuning.

Hawk.Enabled

Controls whether or not TIBCO Hawk can be used to monitor and manage the process engine. Also, allows the Engine Command activity to be used. The following table describes the valid values for this property:

Value

Description

true

Enables both TIBCO Hawk and Engine Command activity usage.

local

Enables only Engine Command activity. TIBCO Hawk cannot be used when this value is used.

false

Disables both TIBCO Hawk and Engine Command activity usage.

Hawk.Service

Specifies the service parameter for the TIBCO Rendezvous transport of your TIBCO Hawk configuration. By default this is set to 7474. For more information about the syntax of the service parameter of TIBCO Rendezvous transports, see the TIBCO Rendezvous documentation .

Hawk.Network

Specifies the network parameter for the TIBCO Rendezvous transport of your TIBCO Hawk configuration. By default this is set to "". For more information about the syntax of the network parameter of TIBCO Rendezvous transports, see the TIBCO Rendezvous documentation .

Hawk.Daemon

Specifies the daemon parameter for the TIBCO Rendezvous transport of your TIBCO Hawk configuration. By default this is set to tcp:host:7474. For more information about the syntax of the daemon parameter of TIBCO Rendezvous transports, see the TIBCO Rendezvous documentation .

Instrumentation.<processName>

Some of the TIBCO Hawk instrumentation methods require runtime actions that impose performance and memory overhead. These actions can be enabled or disabled on a per-process definition basis at any time by setting this property. The actions that can be enabled or disabled are:

Collection of activity statistics for the GetActivity microagent method
Calls to OnProcessActivity and OnProcessStatusChanged microagent methods

Setting the engine property Instrumentation.* to true enables those actions for all process definitions. Setting the property Instrumentation.<processName> to true enables those actions for a specified process definition. Setting this property to false disables the actions.

The instrumentation properties can be set at runtime by calling the TIBCO Hawk setInstrumentProperties method. The property value specified in a call to setInsrumentProperties takes effect immediately.