Bootstrap FreeKB - Introscope - Command Line Workstation (CLW) - List Historical Agents
Introscope - Command Line Workstation (CLW) - List Historical Agents

Updated:   |  Introscope articles

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

 




Did you find this article helpful?

If so, consider buying me a coffee over at Buy Me A Coffee



Comments


Add a Comment


Please enter f5e232 in the box below so that we can be sure you are a human.