Configuring the Microagent in TIBCO® Operational Intelligence Hawk® RedTail
If you are running TIBCO FTL in a containerized environment, you can monitor your FTL applications using TIBCO® OI Hawk® RedTail. TIBCO OI Hawk RedTail is a tool for monitoring distributed applications on both on-premises and container-based PaaS platforms by using rulebases and microagents. To add Hawk® Microagent for TIBCO FTL/TIBCO eFTL plug-in to the Hawk agent container perform the following steps:
Before you begin
- Download and install TIBCO OI Hawk RedTail software package from the TIBCO Software Product Download Site. For more information about TIBCO OI Hawk RedTail, see TIBCO® Operational Intelligence Hawk® RedTail documentation.
- Download and install Hawk® Microagent for TIBCO FTL/TIBCO eFTL in the same
TIBCO_HOME
where you have installed TIBCO OI Hawk RedTail.
- Procedure
- Copy hawkftl.jar and all the dependent jars from <TIBCO_HOME>/<version>/plugin/ftl/lib folder to <TIBCO_HOME>/<version>/redtail/hkceagent/plugin/ftl folder.
- Copy hawkftl.hma and ftlserverconfig.yaml files from <TIBCO_HOME>/<version>/plugin/ftl/ folder to <TIBCO_HOME>/<version>/redtail/hkceagent/plugin/ folder.
- Create logs folder in the <TIBCO_HOME>/<version>/redtail/hkceagent/plugin/ftl directory.
- In the
hawkftl.hma file, update the relative path of the jars. For example:
<classpath>
<path>/redtail/hkceagent/plugin/ftl/lib/hawkftl.jar</path>
<pathdir>/redtail/hkceagent/plugin/ftl/lib/ext</pathdir> </classpath> - In the
hawkftl.hma file, update FTL server details
yaml file location and log file location. For example:
<arg>--ftlServerConfigFile</arg> <arg>/redtail/hkceagent/plugin/ftlserverconfig.yaml</arg> <!--Trace Configuration --> <arg>-traceDir</arg> <arg>/redtail/hkceagent/plugin/logs</arg>
- In the<TIBCO_HOME>/<version>/redtail/hkceagent/plugin/ftlserverconfig.yaml file, update TIBCO FTL server details.
- Rebuild the Hawk agent Docker image by running the script <TIBCO_HOME>/<version>/redtail/build-images/build-scripts/build-hkceagent.sh.
- Run the containers. While running the containers, ensure that the
hma_plugin_dir
environment variable of hawk agent is set to value /redtail/hkceagent/plugin. - If Hawk RedTail Console is running, you can confirm if the plug-in is loaded in Hawk agent by checking the list of microagents in the Hawk RedTail Console. Check if the methods of the plug-in microagent are listed and if you can invoke and subscribe them.