Agent Diagnostic Tool

Agent Diagnostic Tool is a standalone jar java -jar util/diagnostics.jar distributed with the Agent that reads the Agent configuration and allows the user to perform a number of routine setup checks, like:

  • Authenticate using certificates or RSA keys (configured in the Agent config or supplied by the user);

  • Call Agent, Pod, and KM healthchecks and parse the responses;

  • It makes crucial Pod and Agent API calls: read session info, fetch a list of user's streams, create and read messages, create and read the datafeed;

  • It lets you parse the JW tokens used for RSA authentication, in order to debug RSA auth errors (expired tokens, mismatched usernames etc.)

  • Contains a parser for Agent logs to display statistics of the number of calls, calls per second, most frequently used, most active users and apps, as well as an option to export call statistics as CSV data.

The following images show examples of the Agent Diagnostics set menus:

Option [a] - Load the Agent config file:

Option [b] - Display the Agent config file:

Option [c] - Test RSA Authentication tokens:

Agent Diagnostics - option [c]
Agent Diagnostics - option [c] -> [c]
Agent Diagnostics - option [c] -> [d]
Agent Diagnostics - option [c] -> [e]
Agent Diagnostics - option [c] -> [e]
Agent Diagnostics - option [c] -> [e]

Option [d] - Authenticate:

Agent Diagnostics - option [d]
Agent Diagnostics - option [d] -> [c]
Agent Diagnostics - option [d] ->[f]
Agent Diagnostics - option [d] -> [g]

Option [e] - Test API endpoints:

Agent Diagnostics - option [e]
Agent Diagnostics - option [e] -> [a]
Agent Diagnostics - option [e] -> [a]
Agent Diagnostics - option [e] -> [c]
Agent Diagnostics - option [e] -> [d]
Agent Diagnostics - option [e] -> [e]

Option [f] - Analyse Agent Logs

Agent Diagnostics - option [f]
Agent Diagnostics - option [f] -> [b]