EMS Topics

These displays present several views of performance metrics for topics. Clicking EMS Topics from the left/navigation menu opens the TIBCO EMS Topics Table display, which shows performance and utilization metrics and trends for all topics defined on a specified server, including consumer and subscriber count, memory utilization, and message performance metrics. You can also view all servers that have a specific topic defined in the TIBCO EMS Topic Summary display, and you can see a list of all the servers on which those topics are defined on the TIBCO EMS Topic Detail by Server display. The options available under EMS Topics are:

All Topics Summary: Clicking All Topics Summary opens the TIBCO EMS Topics for Server Summary display, which shows performance and utilization metrics and trends for all topics defined on a specified server, including consumer and subscriber count, memory utilization, and message performance metrics.
All Topics Heatmap: Clicking All Topics Heatmap opens the TIBCO EMS Topics Heatmap , which is a heatmap representation of a selected set of metrics from Topics organized by Server that allows you to track performance and utilization metrics and trends for all topics on a single server.
Single Topic Summary: Clicking Single Topic Summary opens the TIBCO EMS Topic Summary which shows detailed performance and utilization metrics and trends for a specified topic on a single server, including producer and consumer counts, and message performance metrics.
Topic Detail by Server: Clicking Topic Detail by Server opens the TIBCO EMS Topic Detail by Server , which shows performance and utilization metrics for all servers that have a specified topic defined, including consumer and subscriber count, and message performance metrics.

 

TIBCO EMS Topics Table

Clicking EMS Topics from the left/navigation menu opens the TIBCO EMS Topics Table display, which allows you to track performance and utilization metrics for all topics on a single server. You can enter a string in the Filter by Topic Name field to show only topics in the table with names that contain the string. For example, if you enter the string Madrid, all topics with Madrid in the topic name are shown in the table. If no entry is made, all topic names are shown. For most use cases, you can enter a portion of the topic name. Double-clicking on a row in the table opens the data for the selected topic in the TIBCO EMS Topic Summary display so that you can view additional metrics for the selected topic.

 

 

Fields and Data

This display includes:

 

EMS Server

The EMS Server selected from this drop-down menu populates all associated Topic data in this display.

 

Filter by Topic Name

Enter a string to show only topics with names that contain the string. For example, if you enter the string Madrid, all topics with Madrid in the topic name are shown in the table. If no entry is made, all topic names are shown. For most use cases, you can enter a portion of the topic name.

 

Shown

The total number of currently active topics on the selected server, which is filtered by the Data Collection > Metric Filters > Topics field in the RTView Configuration Application.

The default value for the Topics property is:

^(?!^\\$sys\\.|^\\$TMP\\$\\.|^AMX_MGMT\\.|^EMSGMS\\.|^AMX_SV\\.|^_HAWK\\.|^_LOCAL\\._HAWK\\.|^TMP\\.EMS)

You can modify the filter value by editing the Topics property, which will override the default value. See “Configuring Data Collection” for more information.

 

Total

The total number of topics on the selected server.

 

Table

This table describes all topics on the selected server. Click a row to view metrics for a single topic in the TIBCO EMS Topic Summary display.

 

 

Topic Name

The name of the topic.

 

URL

The IP address and port number for the server.

 

Alert Level

The current alert level.

-- One or more alerts have exceeded their specified ALARMLEVEL threshold, have an Alert Severity value of 2, and are shown in red.

-- One or more alerts have exceeded their specified WARNINGLEVEL threshold, have an Alert Severity value of 1, and are shown in yellow.

-- No alerts have exceeded an alert threshold, which have an Alert Severity value of 0, and are shown in green.

 

Alert Count

The number of current alerts.

 

In Msgs/s

The number of inbound messages for the topic, per second.

 

In Total Msgs

The total number of inbound messages for the topic.

 

 

Out Msgs/s

The number of outbound messages for the topic, per second.

 

 

Out Total Messages

The total number of outbound messages for the topic.

 

 

Pending Msgs

The number of currently pending messages for the topic.

 

 

Pending Msg Size

The amount of space, in bytes, used by pending messages for the topic.

 

 

Active Durables

The number of currently active durables or the topic.

 

 

Consumers

The number of consumers for the topic.

 

 

Durables

The number of durables for the topic.

 

 

Fail Safe

When checked, the message is marked as failsafe delivery.

 

 

Flow Control Max Bytes

The maximum number of bytes allocated for use by flow control.

 

 

Global

When checked, the message is global and is routed to other servers.

 

 

In KB/s

The amount of inbound messages for the topic, in kilobytes per second.

 

 

In MB

The total amount of inbound messages for the topic, in megabytes, since the server started.

 

 

Max Bytes

The maximum size, in bytes, that the topic can store for delivery to each durable or non-durable online subscriber on that topic.

 

 

Max Msgs

The maximum number of messages before the server indicates an error and overflow policies are activated.

 

 

Out KB/s

The amount of outbound messages for the topic, in kilobytes per second.

 

 

Out MB

The total amount of outbound messages for the topic, in megabytes.

 

 

Overflow Policy

Indicates whether an overflow policy is set for the topic:

0 = No policy is set.

1 = A policy is set.

 

 

Secure

When checked, the topic is designated as secure and enforces permission policies.

 

 

Static

When checked, the topic has a static destination.

 

 

Subscribers

The number of subscribers for the topic.

 

 

Description

Descriptive text to help the administrator identify this resource.

 

 

Current In Total Messages

Displays the change (delta) in inboundTotalMessages from the previous cache refresh to the current cache refresh.

 

 

Current In Total Bytes

Displays the change (delta) in inboundTotalBytes from the previous cache refresh to the current cache refresh.

 

 

Current Out Total Msgs

Displays the change (delta) in outboundTotalMessages from the previous cache refresh to the current cache refresh.

 

 

Current Out Total Bytes

Displays the change (delta) in outboundTotalBytes from the previous cache refresh to the current cache refresh.

 

 

In Msgs/s (TIBCO)

The number of inbound TIBCO messages for the topic, per second.

This metric comes directly from the tibjms.admin.DestinationInfo class from TIBCO.

 

 

Out Msgs/s (TIBCO)

The number of outbound TIBCO messages for the topic, per second.

This metric comes directly from the tibjms.admin.DestinationInfo class from TIBCO.

 

 

In KB/s (TIBCO)

The amount of inbound TIBCO messages for the topic, in kilobytes per second.

 

 

Out KB/s (TIBCO)

The amount of outbound TIBCO messages for the topic, in kilobytes per second.

 

 

Expired

When checked, performance data has not been received within the time specified (in seconds) in the Expire Time field in the Duration region in the RTView Configuration Application > (Project Name) > Solution Package Configuration > TIBCO Enterprise Message Service > DATA STORAGE tab. The Delete Time field (also in the Duration region) allows you to define the amount of time (in seconds) in which the row will be removed from the table if there is no response.

 

 

Time Stamp

The date and time this row of data was last updated.

 

 

TIBCO EMS Topics for Server Summary

Clicking All Topics Summary from the left/navigation menu opens the TIBCO EMS Topics for Server Summary display, which allows you to track performance and utilization metrics and trends for all topics on a single server. Clicking on the server information boxes at the top of the display takes you to the TIBCO EMS Topics Table display, where you can view additional data on all topics. In the trend graph region, you can select from Message Rates, which traces inbound/outbound messages per second, KB Rates, which traces total inbound/outbound messages per second in kilobytes, or Pending Msgs, which traces the total number of messages for all topics on the server currently waiting to be processed and the total size of messages, in megabytes, for all topics on the server currently waiting to be processed. Clicking the Critical/Warning link at the bottom of the display opens the Alerts Table by Component display.

 

 

Fields and Data

This display includes:

 

EMS Server

The EMS Server selected from this drop-down menu populates all associated Topic data in this display.

 

Consumers

The number of consumers currently active on the server.

 

Subscribers

The number of subscribers for the topic.

 

In Msgs/s

The number of inbound messages for the topic, per second.

 

Out Msgs/s

The number of outbound messages for the topic, per second.

 

Pending Messages

The number of currently pending messages for the topic.

 

Pending Msg Size MB

The amount of space, in bytes, used by pending messages for the topic.

 

Trend Graphs

The following trend graphs are available.

 

 

Message Rates

In Msgs/s -- The number of inbound messages for all topics on the server, per second.

Out Msgs/s -- The number of outbound messages for all topics on the server, per second.

Pending Msgs -- The total number of messages for all topics on the server currently waiting to be processed.

 

 

KB Rates

In KB/s -- The size of inbound messages, in kilobytes per second, for all topics on the server.

Out KB/s -- The size of outbound messages, in kilobytes per second, for all topics on the server.

Pending Msg Size KB -- The total size of messages, in bytes, for all topics on the server currently waiting to be processed.

 

 

Pending Msgs

Pending Messages -- The total number of messages for all topics on the server currently waiting to be processed.

Pending Msg Size KB-- The total size of messages, in bytes, for all topics on the server currently waiting to be processed.

 

 

Log Scale

This option should be used when the range of your data is very broad. When checked, the values are displayed using a logarithmic scale rather than using the actual values so that data on the extreme ends of the scale can be viewed more effectively. For example, if you have data that ranges from the tens to the thousands, the data in the range of the tens will be neglected visually if you do not check this option.

 

 

 

Time Settings

Select a time range from the drop down menu varying from 5 Minutes to Last 7 Days. By default, the time range end point is the current time.

 

To change the time range, deselect the now toggle, which displays some additional date fields. You can click the left and right arrow buttons to decrease the end time by one time period (the time selected in the Time range drop down) per click, or you can choose the date and time from the associated calendar and clock icons. You can also enter the date and time in the text field using the following format: MMM dd, YYYY HH:MM:ss. For example, Aug 21, 2018 12:24 PM. Click the now toggle to reset the time range end point to the current time.

 

 

 

Name

The name of the server selected in the EMS Server drop down list.

 

Durables

The number of durables for the topic.

 

In KB/s

The size of inbound messages, in kilobytes per second, for all topics on the server.

 

Out KB/s

The size of outbound messages, in kilobytes per second, for all topics on the server.

 

 

TIBCO EMS Topics Heatmap

Clicking All Topics Heatmap from the left/navigation menu opens the TIBCO EMS Topics Heatmap, which is a heatmap representation of a selected set of metrics from Topics organized by Server that allows you to track performance and utilization metrics and trends for all topics on a single server. This heatmap allows you to view status and alerts of all topics for a server. You can enter a string in the Filter by Topic Name field to show only topics in the table with names that contain the string. For example, if you enter the string Madrid, all topics with Madrid in the topic name are shown in the table. If no entry is made, all topic names are shown. For most use cases, you can enter a portion of the topic name. Use the Metric drop-down menu to view to Alert Severity, Alert Count, Consumers, Durables, Subscribers, Pending Messages, Inbound Message Rate, Inbound Total Messages, Outbound Message Rate, or Outbound Total Messages.

The heatmap is organized so that each rectangle represents a Topic on the selected Server. The rectangle color indicates the value of the selected metric in the Metric drop down list. You can mouse-over rectangles to view more details about the performance and status of each topic or click on a rectangle to drill-down to the TIBCO EMS Topic Summary display and view metrics for that particular Topic.

 

 

Fields and Data

This display includes:

 

EMS Server

The EMS Server selected from this drop-down menu populates all associated Topic data in this display.

 

Filter by Topic Name

Enter a string to show only topics with names that contain the string. For example, if you enter the string Madrid, all topics with Madrid in the topic name are shown in the table. If no entry is made, all topic names are shown. For most use cases, you can enter a portion of the topic name.

 

Shown

The total number of currently active topics on the selected server, which is filtered by the Data Collection > Metric Filters > Topics field in the RTView Configuration Application.

The default value for the Topics property is:

^(?!^\\$sys\\.|^\\$TMP\\$\\.|^AMX_MGMT\\.|^EMSGMS\\.|^AMX_SV\\.|^_HAWK\\.|^_LOCAL\\._HAWK\\.|^TMP\\.EMS)

You can modify the filter value by editing the Topics property, which will override the default value. See “Configuring Data Collection” for more information.

 

Total

The total number of topics on the selected server.

 

Show URL

Select this check box to display the server URL in the heatmap.

 

Log Scale

This option enables visualization on a logarithmic scale, and should be used when the range in your data is very broad. For example, if you have data that ranges from the tens to the thousands, then data in the range of tens will be neglected visually if you do not check this option. This option makes data on both extreme ranges visible by using the logarithmic of the values rather than the actual values.

 

 

Auto Scale

When checked, the values of the selected metric are auto-scaled to its highest defined value. When unchecked, the values of the selected metric display based on the threshold defined for the alert associated with the selected metric. Selecting Auto helps to visualize the range of the values currently present for the selected metric instead of the threshold of the alert that has been associated with the metric. All metrics that have not been associated in the heatmap defaults with alerts use a monochromatic color gradient bar (whites and greens). All metrics that have been associated in the heatmap defaults with alerts use a multi-chromatic color gradient bar (reds, yellows, white, and greens).

 

Metric

Select the metric driving the heatmap display. The default is Alert Severity. Each Metric has a color gradient bar that maps values to colors. The heatmap organizes the topics by server, where each rectangle represents a Topic. Mouse-over any rectangle to display the current values of the metrics for the Topic. Click on a rectangle to drill-down to the associated TIBCO EMS Topic Summary display for a detailed view of metrics for that particular topic.

 

 

Alert Severity

The maximum alert level in the item (index) associated with the rectangle. Values range from 0 to 2, as indicated in the color gradient bar , where 2 is the greatest Alert Severity.

2 -- Metrics that have exceeded their specified ALARMLEVEL threshold and have an Alert Severity value of 2 are shown in red. For a given rectangle, this indicates that one or more metrics have exceeded their alarm threshold.

1 -- Metrics that have exceeded their specified WARNINGLEVEL threshold and have an Alert Severity value of 1 are shown in yellow. For a given rectangle, this indicates that one or more metrics have exceeded their warning threshold.

0 -- Metrics that have not exceeded either specified threshold have an Alert Severity value of 0 and are shown in green. For a given rectangle, this indicates that no metrics have exceeded a specified alert threshold.

 

 

Alert Count

The total number of alarm and warning alerts in a given item (index) associated with the rectangle.

The color gradient bar shows the range of the value/color mapping. The numerical values in the gradient bar range from 0 to the maximum count of alerts in the heatmap. The middle value in the gradient bar indicates the middle value of the range.

 

 

Consumers

The total number of consumers in a given item (index) associated with the rectangle. The color gradient bar shows the value/color mapping. The numerical values in the gradient bar range from 0 to the maximum count of consumers in the heatmap. The middle value in the gradient bar indicates the middle value of the range.

The Auto Scale option does not impact this metric.

 

 

Durables

The total number of active durables in a given item (index) associated with the rectangle. The color gradient bar shows the range of the value/color mapping. The numerical values in the gradient bar range from 0 to the maximum count of durables in the heatmap. The middle value in the gradient bar indicates the middle value of the range.

 

 

Subscribers

The total number of subscribers in a given item (index) associated with the rectangle. The color gradient bar shows the range of the value/color mapping. The numerical values in the gradient bar range from 0 to the maximum count of subscribers in the heatmap. The middle value in the gradient bar indicates the middle value of the range.

 

 

Pending Msgs

The total number of pending messages in a given item (index) associated with the rectangle. The color gradient bar shows the range of the value/color mapping. By default, the numerical values in the gradient bar range from 0 to the alert threshold of EmsTopicssPendingMsgsHigh, which is 3000. The middle value in the gradient bar indicates the middle value of the range (the default is 1500).

When Auto Scale is checked, the numeric values in the color gradient bar show the range of the data being displayed rather than the default values. The middle value changes accordingly to indicate the color of the middle value of the range.

 

 

In Msg /sec

The number of inbound messages per second in a given item (index) associated with the rectangle. The color gradient bar shows the range of the value/color mapping. By default, the numerical values in the gradient bar range from 0 to the alert threshold of EmsTopicsInMsgRateHigh, which is 9. The middle value in the gradient bar indicates the middle value of the range (the default is 4.5).

When Auto Scale is checked, the numeric values in the color gradient bar show the range of the data being displayed rather than the default values. The middle value changes accordingly to indicate the color of the middle value of the range.

Note: This metric comes directly from the tibjms.admin.DestinationInfo class from TIBCO.

 

 

In Total Msg

The total number of inbound messages in a given item (index) associated with the rectangle. The color gradient bar shows the range of the value/color mapping. The numerical values in the gradient bar range from 0 to the maximum count of receivers in the heatmap. The middle value in the gradient bar indicates the middle value of the range.

The Auto Scale option does not impact this metric.

 

 

Out Msg/sec

The number of outbound messages per second in a given item (index) associated with the rectangle. The color gradient bar shows the range of the value/color mapping. By default, the numerical values in the gradient bar range from 0 to the alert threshold of EmsTopicsOutMsgRateHigh, which is 9. The middle value in the gradient bar indicates the middle value of the range (the default is 4.5).

When Auto Scale is checked, the numeric values in the color gradient bar show the range of the data being displayed rather than the default values. The middle value changes accordingly to indicate the color of the middle value of the range.

Note: This metric comes directly from the tibjms.admin.DestinationInfo class from TIBCO.

 

 

Out Total Msgs

The total number of outbound messages in a given item (index) associated with the rectangle. The color gradient bar shows the range of the value/color mapping. The numerical values in the gradient bar range from 0 to the maximum count of receivers in the heatmap. The middle value in the gradient bar indicates the middle value of the range.

The Auto Scale option does not impact this metric.

 

TIBCO EMS Topic Summary

Clicking Single Topic Summary from the left/navigation menu opens the TIBCO EMS Topic Summary display, which allows you to track performance and utilization metrics for a single topic on a single server. Clicking any of the messages boxes at the top of the display takes you to the TIBCO EMS Topics Table display, where you can view additional data on all topics. In the trend graph region, you can select from Message Rates, which traces inbound/outbound messages per second, or Message Flows, which traces total inbound/outbound messages in bytes. Clicking the Critical/Warning link at the bottom of the display opens the Alerts Table by Component display.

 

 

Filters

 

EMS Server

The EMS Server selected from this drop-down menu populates the Topic drop-down menu with the Topics belonging to this EMS Server.

 

Topic

Select the topic for which you want to view data in the display.

Fields and Data

This display includes:

 

Pending Messages

The number of messages for the selected topic currently waiting to be processed.

 

Subscribers

The number of subscribers for the topic.

 

In Msgs/s

The number of inbound messages, per second, for the selected topic.

 

Out Msgs/s

The number of outbound messages, per second, for the selected topic.

 

In KB/s

The size of inbound messages, in kilobytes per second, for the selected topic.

 

Out KB/s

The size of outbound messages, in kilobytes per second, for the selected topic.

 

Trend Graphs

Message Rates

In Msgs / sec -- Traces the number of inbound messages, per second. This trend graph only displays when Use Rates is selected.

Out Msgs / sec -- Traces the number of outbound messages, per second. This trend graph only displays when Use Rates is selected.

Pending Msgs -- Traces the number of messages currently waiting to be processed.

Message Flows

In Msgs -- Traces the number of inbound messages.

Out Msgs -- Traces the number of outbound messages

Pending Msgs -- Traces the number of messages currently waiting to be processed.

 

 

Log Scale

This option should be used when the range of your data is very broad. When checked, the values are displayed using a logarithmic scale rather than using the actual values so that data on the extreme ends of the scale can be viewed more effectively. For example, if you have data that ranges from the tens to the thousands, the data in the range of the tens will be neglected visually if you do not check this option.

 

 

 

Time Settings

Select a time range from the drop down menu varying from 5 Minutes to Last 7 Days. By default, the time range end point is the current time.

 

To change the time range, deselect the now toggle, which displays some additional date fields. You can click the left and right arrow buttons to decrease the end time by one time period (the time selected in the Time range drop down) per click, or you can choose the date and time from the associated calendar and clock icons. You can also enter the date and time in the text field using the following format: MMM dd, YYYY HH:MM:ss. For example, Aug 21, 2018 12:24 PM. Click the now toggle to reset the time range end point to the current time.

 

 

 

Durables

The number of durable subscribers (active and inactive) to the topic.

 

Critical/Warning

The total number of critical and warning alerts for the server.

 

Pending Message Size MB

The size of the messages for the selected topic, in megabytes, currently waiting to be processed.

 

Max MB

The maximum of memory, in megabytes, allocated for use by the topic.

 

FC Max MB

The maximum amount of memory, in megabytes, allocated for flow control use by the topic.

 

Global

When true, the message is global and is routed to other servers.

 

Static

When true, the topic has a static destination.

 

Fail Safe

When true, the message is marked as failsafe delivery.

 

Secure

When true, the topic is designated as secure and enforces permission policies.

 

Overflow Policy

Indicates whether an overflow policy is set for the topic:

0 = No policy is set.

1 = A policy is set.

 

Max Msgs

The maximum number of messages allocated for the topic.

 

Last Update

The date and time of the last data update.

 

 

TIBCO EMS Topic Detail by Server

Clicking Topic Detail by Server in the left/navigation menu opens the TIBCO EMS Topic Detail by Server display, which allows you to track performance and utilization metrics of a single topic across all servers that have the topic defined on it and compare topic activity among servers. Double-clicking any of the rows in the table takes you to the TIBCO EMS Topic Summary display, where you can view additional data for that particular topic on that particular server.

 

 

Filters

 

Topic

The Topic selected from this drop-down menu populates this display.

Fields and Data

This display includes:

 

Count

The number of topics listed in the table.

 

Table

Shows details about the selected Topic for each server that has the Topic defined. Double-click on a table row to view details in the TIBCO EMS Topic Summary display.

 

 

URL

The IP address and port number for the server.

 

In Msgs/s

The amount of inbound messages for the topic, in number of messages per second.

 

In Total Msgs

The total number of inbound messages for the topic.

 

Out Msgs/s

The number of outbound messages per second.

 

Out Total Msgs

The total number of outbound messages for the topic since the server was started.

 

Pending Msgs

The number of currently pending messages for the topic.

 

Pending Msg Size

The amount of space, in bytes, pending messages use for the topic.

 

Active Durables

The number of currently active durables.

 

Consumers

The current number of consumers.

 

 

Durables

The number of active and inactive durables.

 

Fail Safe

When checked, the message is marked as failsafe delivery.

 

Flow Control Max Bytes

The maximum number of bytes allocated for use by flow control.

 

 

Global

When checked, the message is global and is routed to other servers.

 

 

In KB/s

The amount of inbound messages for the topic, in kilobytes per second.

 

In MB

The total number of inbound megabytes for the topic.

 

 

Max Bytes

The maximum size, in bytes, that the topic can store for delivery to each durable or non-durable online subscriber on the topic.

 

 

Max Msgs

The maximum number of messages allocated for use by the topic.

 

 

Out KB/s

The amount of outbound messages (in kilobytes) per second.

 

 

Out MB

The total amount of outbound messages for the topic, in megabytes, since the server was started.

 

 

Overflow Policy

Policy Indicates whether an overflow policy is set for the topic:

0 = No policy is set.

1 = A policy is set.

 

 

Secure

When checked, the topic is designated as secure and enforces permission policies.

 

 

Static

When checked, the topic has a static destination.

 

Subscribers

The number of subscribers for the topic.

 

Description

Descriptive text to help the administrator identify this resource.

 

Current In Total Msgs

Displays the change (delta) in inbound total messages from the previous cache refresh to the current cache refresh.

 

Current In Total Bytes

Displays the change (delta) in inbound total bytesfrom the previous cache refresh to the current cache refresh.

 

Current Out Total Msgs

Displays the change (delta) in outbound total messages from the previous cache refresh to the current cache refresh.

 

Current Out Total Bytes

Displays the change (delta) in outbound total bytes from the previous cache refresh to the current cache refresh.

 

Expired

When checked, performance data has not been received within the time specified (in seconds) in the Expire Time field in the Duration region in the RTView Configuration Application > (Project Name) > Solution Package Configuration > TIBCO Enterprise Message Service > DATA STORAGE tab. The Delete Time field (also in the Duration region) allows you to define the amount of time (in seconds) in which the row will be removed from the table if there is no response.

 

 

time_stamp

The date and time this row of data was last updated.