Monitoring Tibco EMS

Supported Versions

Confirmed support for metrics and configuration data for versions: 8.3.x, 8.4.x, 8.5.x, 8.6.x.

Configuration

The defualt poll rate of metrics is 5 seconds. You can change the poll rate in the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.tibcoems:
  poll_rate: 5  # seconds

If you lower the value of the poll rate, the CPU usage of the Tibco EMS process will be increased.

In case the instance requires a user/password authorization, you need to configure them in the agent configuration file as well.

com.instana.plugin.tibcoems:
  user: ''      # default is 'admin'
  password: ''

Instana agent will try to automatically resolve the hostname and port from the Tibco EMS configuration file. In case a custom hostname and port should be used, you can configure them in the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.tibcoems:
  hostname: '' # optional
  port: ''     # optional

Configuring multiple Tibco EMS instances monitoring 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 matching expressions in the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml. For example:

com.instana.plugin.tibcoems:
   queuesRegex: 'bar.>'
   topicsRegex: 'foo.>'  

For more information about using the Wildcards to select queues and topics, refer to the Official Tibco EMS docs

statistics = enabled

set server statistics=enabled

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

Metrics collection

To view the metrics, select Infrastructure in the sidebar of the Instana User interface, click a specific monitored host, and then you can see a host dashboard with all the collected metrics and monitored processes.