Configuration and Script Examples

To verify that your TIBCO Messaging Monitor for TIBCO Enterprise Message Service installation is ready for configuration and deployment, perform the following general tasks and confirmations. This topic contains simple default configurations and usage examples; your requirements may vary.

Before you begin
  • Ensure that you have Python 3 and Java installed before you begin.
  • Run the following script to install any Python dependencies required by EMS Monitoring:
    pip3 install -r /opt/tibco/msgmon/ems/requirements.txt

Edit the config/ems_config.yaml file

Begin by editing the ems_config.yaml file, which is located in /opt/tibco/msgmon/ems/config/

This file contains configuration information pertaining to the EMS cluster to be monitored. Edit this file to enter specifics about your EMS cluster. You may need to modify the following fields:

settings:
    grafana:
        url, username, password
        datasource:
            type, access, basicAuth, isDefault

    influxDB:
        url, username, password

The default configuration in MSGMON Core at /opt/tibco/msgmon/config/ should be sufficient to start the InfluxDB and Grafana services.

Start EMS Monitoring

Note: The configured maximum number of file handlers must be high enough for InfluxDB to monitor multiple EMS services in parallel. You can see the file handlers limit by executing "ulimit -n". You can set the file handlers limit by executing "ulimit -n <int>".

Start monitoring using the following procedure:

  1. Change to the monitoring directory:
    cd /opt/tibco/msgmon/ems/
  2. Run the start script.
    python3 bin/msgmon-ems-start.py -ec config/ems_config.yaml

    You see an output similar to the following:

    TIBCO Messaging Monitoring - TIBCO EMS Plugin
    
    *************************************
     INFO    [argument_parser.py:84] MSGMON-EMS logging level set to INFO
     INFO    [validate.py:40] Validation successful. EMS-config @/opt/tibco/msgmon/ems/config/ems_config.yaml
     INFO    [starter.py:38] Status File @ : /var/tmp/user/tibco-msgmon/status/tibemsmon.yaml
     INFO    [starter.py:64] Status File loaded from: /var/tmp/user/tibco-msgmon/status/tibemsmon.yaml
     WARNING [starter.py:50] Restarting tibemsmon instance.
     INFO    [starter.py:119] tibemsmon logging path: /var/tmp/user/tibco-msgmon/logs/tibemsmon.log
     INFO    [starter.py:120] tibemsmon err path: /var/tmp/user/tibco-msgmon/logs/tibemsmon.err
    openjdk version "13.0.9" 2021-10-19
    OpenJDK Runtime Environment Zulu13.44+13-CA (build 13.0.9+3-MTS)
    OpenJDK 64-Bit Server VM Zulu13.44+13-CA (build 13.0.9+3-MTS, mixed mode, sharing)
     INFO    [starter.py:198] tibemsmon started @pid : 25766
Note: To see all available options, use the -h option.

Check Monitoring Status

To check that the monitoring for all of the cluster elements has started, enter:

python3 bin/msgmon-ems-status.py  

You see an output similar to the following:

*************************************

TIBCO Messaging Monitoring - TIBCO EMS Plugin

*************************************
 INFO    [msgmon-ems-status.py:140] MSGMON-EMS logging level set to INFO
 INFO    [msgmon-ems-status.py:96] Status File loaded from: /var/tmp/user/tibco-msgmon/status/tibemsmon.yaml

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  tibemsmon Status : Running

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To see detailed information about the status of EMS clusters being monitored, use the command using the --detailed option as follows:

python3 bin/msgmon-ems-status.py --detailed. 

Stop Monitoring

To stop monitoring of your EMS cluster, run the stop script:

python3 bin/msgmon-ems-stop.py

You see an output similar to the following:

*************************************

TIBCO Messaging Monitoring - TIBCO EMS Plugin

*************************************
 INFO    [msgmon-ems-stop.py:171] MSGMON-EMS logging level set to INFO
 INFO    [msgmon-ems-stop.py:115] Status File loaded from: /var/tmp/user/tibco-msgmon/status/tibemsmon.yaml
 INFO    [msgmon-ems-stop.py:123] Stopped process tibemsmon running with pid: 25766
 INFO    [msgmon-ems-stop.py:141] Status File written to : /var/tmp/user/tibco-msgmon/status/tibemsmon.yaml