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.
- 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
Start monitoring using the following procedure:
- Change to the monitoring directory:
cd /opt/tibco/msgmon/ems/
- 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
-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