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. 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 historical agent will be listed.
java -Duser=<your username> -Dpassword=<your password> -Dhost=<hostname> -jar CLWorkstation.jar list historical agents
Which will return a list like this.
server001|Tomcat|JVM1 server001|Tomcat|JVM2 server002|Tomcat|JVM1 server002|Tomcat|JVM2
Unlike other similar command-line workstation commands, list historical agents does not allow you to return a list of agents matching a regular expression, like this:
list historical agents matching .*foo.*
However, you can return a list of agents that have been turned off within a certain time period. For example, to list all of the agents that have been turned off in the year 2019. This list will not only list the agents that are currently turned off. Instead, this will return a list of any agent that was turned off in the specified time period, even including agents that are no longer being monitored by Introscope.
java -Duser=<your username> -Dpassword=<your password> -Dhost=<hostname> -jar CLWorkstation.jar list historical agents between "\2019-01-01 00:00:00\" and \"2019-12-31 23:59:59\"
If you have updated Command Line Workstation to log events at log level DEBUG, IntroscopeEnterpriseManager.log will return the number of historical agents that were returned, like this.
m/dd/yy hh:mm:ss AM CDT [DEBUG] [Manager.AgentBean] Returning 10 historical agents