BW Monitor

RTView® BW Monitor
User Guide

Using the Monitor - BW Engines
These displays present performance metrics for BW Engines:

All Engines Heatmap - Performance metrics of CPU and memory utilization for all BW Engines.
All Engines Table - Available metrics from the Hawk microagent for each BW Engine.
All Engines Grid - Displays the main health metrics and a single trend graph per engine, summarizing the status of each BW Engine.
Single Engine Summary - Detailed performance metrics and alert status for a single BW Engine.

All Engines Heatmap
Quick view of BW Engines status determined by selected Filter and Server, where size equals Max Heap Size and color equals selected Metric. Each rectangle (node) in the heatmap represents an engine.

Click on a node to drill down to the Single Engine Summary display to look at number of processes running, threads, history of memory utilization and other performance metrics for a specific engine. Mouse-over nodes to view details about engine performance and status.

For details about display title bar functionality, see Title Bar Functionality.

For details about reading heatmaps, see Heatmaps.

Filter	Select from a list of custom defined filters or No Filter. Filters limit display content and drop down menu selections to only those items that pass through the selected filter criteria. Therefore if no items match the filter, you may see nothing in a given display and may not have any options available in the dropdown menu(s). NOTE: Filter selection is disabled on drill down summary displays.
Server	Select from the menu to view engines running on a specific server or all servers.

Labels	Use this slider to determine the level of visibility of labels on the Heatmap. NOTE: The maximum label nesting depth that can be shown differs for each heatmap.
Engine Count	Total number of BW Engines.
Active	Number of engines currently active.
Log	If selected, the Metric will be displayed in the color heatmap using a log scale. Using this log scale helps differentiate boxes at the lower end of the scale when there is a wide range between low and high metric values.
Auto	If selected, the Metric will be displayed with auto-scaling. When auto-scaling is activated, the color gradient bar's maximum range displays the highest value. NOTE: Some metrics auto-scale automatically, even when Auto is not selected.
Metric	Select a Metric from the drop down menu. Values of the heatmap's color range are displayed on the color gradient bar.

All Engines Table
Each row in the table displays all metrics available from the Hawk microagent for an engine. (Refer to documentation for TIBCO ActiveMatrix Business Works Administration, see Appendix A: TIBCO Hawk Microagent Methods). Click on an row in the table to drill down to the Single Engine Summary display.

For details about display title bar functionality, see Title Bar Functionality.

Filter	Select from a list of custom defined filters or No Filter. Filters limit display content and drop down menu selections to only those items that pass through the selected filter criteria. Therefore if no items match the filter, you may see nothing in a given display and may not have any options available in the dropdown menu(s). NOTE: Filter selection is disabled on drill down summary displays.
Server	Select from the menu to view engines running on a specific server or all servers.

Engine Name Filter	Enter all or part of engine name to view specific engines. NOTE: Wild card characters are supported.
Clear	Removes Engine Name Filter and all engines for the given Filter/Server selection are displayed.
Show Active Only	If selected, only engines with a status of ACTIVE are displayed. Otherwise, if deselected, all engines for the given Filter/Server selection are displayed.
Count	Number of engines currently being displayed.
RegEx	If selected, the specified Engine Name Filter will be interpreted as a full Regular Expression rather than a simple wildcard.

Table
	BW Engine	BW Engine name.
	Server	Server agent name.
	Expired	See Single Engine Summary.
	Alert Level	Highest alert level current
	AlertCount	Number of current alerts
	State	Engine status: ACTIVE, STOPPED, LIMITED, etc. (See All Servers Grid).
	Uptime	Uptime in milliseconds since the engine was started.
	CPU %	Percent of server CPU used by engine.
	ActiveProcesses	Number of active processes calculated each update period using data returned by the Hawk method GetProcesses.
	RunningProcesses	Number of running processes.
	Threads	Number of threads used by the engine.
	Memory Used %	Percentage of allocated memory currently consumed by this engine from within the JVM. Equal to the value of: (100*UsedBytes) divided by MaxBytes. NOTE: Percent used is Long.
	MaxHeapSize	Maximum heap allocated to this engine for the JVM.
	TotalBytes	Maximum heap memory this JVM has used.
	UsedBytes	Total bytes of memory within the JVM currently used by the engine. Equal to value of: MaxBytes minus FreeBytes.
	FreeBytes	Amount of available memory from within the JVM.
	Mem Usage KBytes	Server memory in KB used by engine.
	Errors	Total number of errors since the engine was started.
	DeltaErrors	Current number of new errors.
	RateErrors	Error rate per second.
	Process ID	Process ID of engine as recognized by the server.
	MicroAgentInstance	Unique ID of the microagent reporting the metrics.
	Deployment	Name of Deployment.
	Domain	Name of Domain.
	BW Version	The TIBCO BusinessWorks version currently in use on the server.
	Source	Name of RTView Data Server sending this data (or localhost).
	Time Stamp	Time of last update.
	NOTE: Although the following metrics are not displayed in the table they are present in "raw" cache data.
	Process Name	Name of the BW Engine process on the server.
	Host	Host name of server.
	Adapter Name	Name of adapter.
	Instance ID	Instance ID name of the engine.
	Version	Engine project version number.

All Engines Grid
Displays the main health metrics and a single trend graph per engine, summarizing the status of each BW Engine.Click on an engine icon to drill down to the Single Engine Summary display.

For details about display title bar functionality, see Title Bar Functionality.

Filter	Select from a list of custom defined filters or No Filter. Filters limit display content and drop down menu selections to only those items that pass through the selected filter criteria. Therefore if no items match the filter, you may see nothing in a given display and may not have any options available in the dropdown menu(s). NOTE: Filter selection is disabled on drill down summary displays.
Server	Select from the menu to view engines running on a specific server or all servers.

Show Active Only	Toggle this setting to display active servers or all servers.
Time Range	Select time range from the menu for trends. Also sets range for Single Engine Summary.

Grid	BW Engine		Name of engine.
	Status	Color-coded icon indicates the current state of the engine.
		ACTIVE		Indicates the BW microagent is providing live data and the engine is assumed active.
		SUSPENDED		This state is reported by the BW microagent.
		STANDBY		This state is reported by the BW microagent.
		STOPPING		This state is reported by the BW microagent.
		STOPPED		This state is reported by the BW microagent.
		LIMITED		Live data has been received from TIBCO, but deployment data from the custom RTView microagent has not been received.
		EXPIRED		Indicates the server associated with the engine is unavailable or stopped sending data. A server is EXPIRED when the threshold specified by the $bwserverExpirationTime substitution is exceeded. The default is 75 seconds. An EXPIRED engine is deleted from displays when the associated server $bwserverExpirationTimeForDelete substitution exceeds its specified threshold. The default is 3600 seconds. Processes and activities associated with the engine are also deleted from displays.
	CPU Usage%		Percentage of CPU currently consumed by this engine from within the JVM.
	Mem Usage %		Percentage of memory currently consumed by this engine from within the JVM.
	Error Rate		Number of errors accumulated per second.
	Total Processes		Number of process definitions for this engine.
	Active Processes		Number of process instances currently active.
	Trend Graph		Shows data for the engine.
			CPU	CPU Usage
			MEM	Memory Usage
			PROCS	Total number of Processes

Single Engine Summary
Several views show historical and current performance metrics for a single engine, including the number of processes running, threads, history of memory utilization, and trend graphs of memory utilization.

For details about display title bar functionality, see Title Bar Functionality.

Filter	Select from a list of custom defined filters or No Filter. Filters limit display content and drop-down menu selections to only those items that pass through the selected filter criteria. Therefore if no items match the filter, you may see nothing in a given display and may not have any options available in the drop-down menu(s). NOTE: Filter selection is disabled on drill-down summary displays.
Server	Select a BW server from the drop-down menu to view data for a specific server. The selection made here populates this display.
Engine	Select a BW engine from the drop-down menu to view data for a specific engine . The selection made here populates this display.

Engine Information	Status			ACTIVE	The BW microagent is providing live data and the engine is assumed active.
				SUSPENDED	This state is reported by the BW microagent.
				STANDBY	This state is reported by the BW microagent.
				STOPPING	This state is reported by the BW microagent.
				STOPPED	This state is reported by the BW microagent.
				LIMITED	Live data has been received from TIBCO, but deployment data from the custom RTView MicroAgent has not been received.
				EXPIRED	The associated server for the engine is currently in an EXPIRED state and is unavailable or stopped sending data. A server is EXPIRED when the threshold specified by the $bwserverExpirationTime substitution is exceeded. The default is 75 seconds. An EXPIRED server is deleted from displays when the threshold specified by the $bwserverExpirationTimeForDelete substitution is exceeded. The default is 3600 seconds. Engines, processes and activities associated with the server are also deleted from displays.
	Uptime			Days hours and minutes since the engine was started.
	CPU %			Percent of server CPU used by engine.
	Memory %			Available physical memory remaining (in MB).
	Threads			Number of threads used by this engine
	Max Heap MB			Maximum heap allocated to this engine for the JVM.

Error Counts	Total		Total errors accumulated by this engine.
	Current		Number of errors accumulated this update cycle.

Process Counts	Total		A BW Engine runs processes by creating instances of process definitions and making them active. A given process instance has a lifetime during which it may be suspended, swapped, queued, etc. until it is either completed or aborted. The Total value is calculated using the Hawk method named GetProcessDefinitions that returns statistics about the instances of each process definition including cumulative counts of completed, aborted, suspended, etc.
	Running		Total number of running process instances. This number is calculated using the Hawk method named GetProcessCount. It is displayed in the BW Monitor Engines Table as RunningProcesses. The trend below displays the same value over time as Running Procs.

Alert Indicators	Click on any alert indicator to drill down to the BW Engine - Tables display to view current alerts for the selected engine.
	Engine		Number of engine alerts.
	Process		Number of process alerts.
	Activity		Number of activity alerts.

Heatmap	Processes organized by Server/Engine where Size = Creation Count and Color = Average Execution. Click on a node to drill down to a specific engine.

Trends	Log Scale	Use a logarithmic scale for the Y axis.
	Base at Zero	Use zero as the Y axis minimum for all graph traces.
	Time Range	Select a time range from the drop down menu varying from 2 Minutes to Last 7 Days, or display All Data. To specify a time range, click the button. By default, the time range end point is the current time. To change the time range end point, click the button and select a date and time from the calendar or enter the date and time in the text field using the following format: MMM dd, YYYY HH:MM. For example, Aug 21, 2011 12:24 PM. Use the navigation arrows to move forward or backward one time period. NOTE: The time period is determined by your selection from the Time Range drop-down menu. Click Restore to Now to reset the time range end point to the current time.

SL, SL-GMS, GMS, RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2013 Sherrill-Lubinski Corporation. All Rights Reserved.

JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only.

Third Party Notice Requirements