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
    Procedure
  1. 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.
  2. Copy hawkftl.hma and ftlserverconfig.yaml files from <TIBCO_HOME>/<version>/plugin/ftl/ folder to <TIBCO_HOME>/<version>/redtail/hkceagent/plugin/ folder.
  3. Create logs folder in the <TIBCO_HOME>/<version>/redtail/hkceagent/plugin/ftl directory.
  4. 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>
  5. 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>
  6. In the<TIBCO_HOME>/<version>/redtail/hkceagent/plugin/ftlserverconfig.yaml file, update TIBCO FTL server details.
  7. Rebuild the Hawk agent Docker image by running the script <TIBCO_HOME>/<version>/redtail/build-images/build-scripts/build-hkceagent.sh.
  8. 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.
  9. 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.