Monitoring Applications by Using TIBCO Hawk Microagent

ActiveMatrix Service Grid - Container Edition embeds a TIBCO Hawk microagent whose methods enable you to monitor and manage deployed ActiveMatrix Service Grid - Container Edition applications. You can use the Hawk Console to perform many administrative functions. There is one Hawk microagent for each AMXCE application or node. The Hawk agent runs on each Kubernetes node. The Hawk agent runs as a daemon set.

Before you begin

You must deploy TIBCO Hawk - Container Edition components with ActiveMatrix Service Grid - Container Edition on Kubernetes. For complete instructions, see "Deploying TIBCO Hawk - Container Edition in Kubernetes" topic in TIBCO ActiveMatrix® Service Grid - Container Edition Cloud Deployment.

    Procedure

  1. Navigate to http://<Console_host_IP>:<Host_port>/HawkConsole. For example: http://<host>:31083/HawkConsole. Where 31083 is default NodePort specified in the sample hawk.yaml file.

  2. On the Hawk Console login page, enter your login credentials for the Hawk Console and click Login. The default user name and password are admin.

  3. Navigate to Domain card > Hawk Agent > Agent Dashboard. Click on the Microagents tab. The microagent default display name is <HostName>_<AMXCE Node Name>. Here <HostName> is combination of Kubernetes deployment name and container id. This microagent provides methods for monitoring ActiveMatrix Service Grid - Container Edition applications.

Microagent Display Name

The microagent default display name is <HostName>_<AMXCE Node Name> as highlighted in the previous image. Here <HostName> is combination of Kubernetes deployment name and container id.

You can override this by setting the following environment variable name in the Kubernetes deployment YAML file:

microagent_name_suffix: After setting this environment variable, microagent display name changes to <HostName>_<microagent_name_suffix>.

Microagent Name

The default name of a microagent is com.tibco.hawk.amxce.<AMXCE Node Name> as highlighted in the following image.

You can override this by setting the following environment name in the Kubernetes deployment YAML file:

microagent_name_suffix: After setting this environment variable, the microagent name changes to com.tibco.hawk.amxce.<microagent_name_suffix>.

Methods

The methods in the microagent are used to change monitoring configurations and return components and bindings information.