If you are not familar with the basic usage of Command Line Workstation (CLW), check out our getting started article. The list agents command is used to list agents that are mounted in Introscope. If you are not familiar with how an agent gets added to Introscope, check out our articles on how to add a Tomcat JVM to Introscope or how to add a WebSphere JVM to Introscope. The "list historical agents" command is used to list agents that are unmounted from Introscope.

Let's say you've a couple servers with a couple JVMs.

In this example, every agent will be listed.

java -Duser=<your username> -Dpassword=<your password> -Dhost=<hostname> -jar CLWorkstation.jar list agents matching "(.*)"

Which will return a list like this.

server001|Tomcat|JVM1
server001|Tomcat|JVM2
server002|Tomcat|JVM1
server002|Tomcat|JVM2

If you want to list a single agent.

java -Duser=<your username> -Dpassword=<your password> -Dhost=<hostname> -jar CLWorkstation.jar list agents matching .*server002|Tomcat|JVM1.*

Returns just a single agent.

server002|Tomcat|JVM1

If you have updated Command Line Workstation to log events at log level DEBUG, IntroscopeEnterpriseManager.log will return the number of agents that were returned, like this.

mm/dd/yy hh:mm:ss AM CDT [DEBUG] [Manager.AgentBean] XXXXX getAgents(agentSpec) returning 10 agents