Monitoring Tibco EMS

Supported Versions

Currently the only supported version for metrics and configuration data is 8.5.1.

Configuration

Instana agent will automatically try to resolve hostname and port from Tibco EMS configuration file.

To use a custom hostname, port, user, or password you need to configure the following fields in the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.tibcoems:
  hostname: ''
  port: ''
  user: ''
  password: ''

Defining configuration for multiple Tibco EMS instances is available using configuration from process environment and files.

Note: The minimum required permissions to access metrics for a non-admin user are:

  • view-destination
  • view-server

To grant the above privileges to a user, run the following commands in the tibemsadmin command line tool:

grant admin user=${username} view-destination
grant admin user=${username} view-server

To configure the topics and queues you want to monitor, specify the regular expressions in the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.tibcoems:
  topicsRegex: ''
  queuesRegex: ''

Enabling statistics

To collect metrics, statistics need to be enabled. There are two ways to enable it:

  1. Either add the following line to tibemsd.conf file and restart the server:

    statistics = enabled
  2. Or using tibemsadmin, run the following command:

    set server statistics=enabled

Providing drivers

When the agent starts and discovers a Tibco EMS server where the driver has not been supplied, the agent logs this message:

Cannot monitor Tibco EMS without the following drivers: tibjms-8.5.1.jar, tibjmsadmin-8.5.1.jar
For licensing reasons they cannot be provided by Instana and
need to be manually obtained and added to the agent

Usually, the drivers are available in the <tibco installation dir>/lib/tibjms.jar and <tibco installation dir>/lib/tibjmsadmin.jar files.

To add the drivers to the agent, add them to the following locations respectively <agent_install_dir>/system/com/tibco/tibjms/tibjms/8.5.1 and <agent_install_dir>/system/com/tibco/tibjms/tibjmsadmin/8.5.1.

Metrics collection

Configuration data

  • Server name
  • Version
  • PID
  • Start time / Up time
  • Ports
  • State
  • Max connections
  • Topics
  • Queues

Performance metrics

Server

Metric Description Granularity
Connections The total number of connections on the server and is collected from the ServerInfo. 1 second
Sessions The total number of sessions on the server and is collected from the ServerInfo. 1 second
Durables The total number of durables on the server and is collected from the ServerInfo. 1 second
Read operations rate The number of read operations per second on the server and is collected from the ServerInfo. 1 second
Write operations rate The number of write operations per second on the server and is collected from the ServerInfo. 1 second
Pending messages count The total number of pending messages on the server and is collected from the ServerInfo. 1 second
Pending messages size The total size of pending messages on the server and is collected from the ServerInfo. 1 second
Message memory The amount of memory in use to store messages on the server and is collected from the ServerInfo. 1 second
In Messages Count The total number of inbound messages on the server and is collected from the ServerInfo. 1 second
Out Messages Count The total number of outbound messages on the server and is collected from the ServerInfo. 1 second
In Messages Rate The number of inbound messages per second on the server and is collected from the ServerInfo. 1 second
Out Messages Rate The number of outbound messages per second on the server and is collected from the ServerInfo. 1 second

Topics

Metric Description Granularity
Subscribers The total number of subscribers on the topic and is collected from the TopicInfo. 1 second
Pending messages count The total number of pending messages on the topic and is collected from the TopicInfo. 1 second
Pending messages size The total size of pending messages on the topic and is collected from the TopicInfo. 1 second
In Messages Count The total number of inbound messages on the topic and is collected from the TopicInfo. 1 second
Out Messages Count The total number of outbound messages on the topic and is collected from the TopicInfo. 1 second
In Messages Rate The number of inbound messages per second on the topic and is collected from the TopicInfo. 1 second
Out Messages Rate The number of outbound messages per second on the topic and is collected from the TopicInfo. 1 second

Queues

Metric Description Granularity
Receivers The total number of receivers on the queue and is collected from the QueueInfo. 1 second
Pending messages count The total number of pending messages on the queue and is collected from the QueueInfo. 1 second
Pending messages size The total size of pending messages on the queue and is collected from the QueueInfo. 1 second
In Messages Count The total number of inbound messages on the queue and is collected from the QueueInfo. 1 second
Out Messages Count The total number of outbound messages on the queue and is collected from the QueueInfo. 1 second
In Messages Rate The number of inbound messages per second on the queue and is collected from the QueueInfo. 1 second
Out Messages Rate The number of outbound messages per second on the queue and is collected from the QueueInfo. 1 second

Health signatures

For each sensor, there is a curated knowledgebase of health signatures that are evaluated continuously against the incoming metrics and are used to raise issues or incidents depending on user impact.

Built-in events trigger issues or incidents based on failing health signatures on entities, and custom events trigger issues or incidents based on defined thresholds of any given entity's individual metrics.

For information about built-events for the Tibco EMS, see the Built-in events reference.