When installing Foglight Java agent with Tomcat, a very common request is to put the servers in a specific system and to give the servers a specific name.
Out of the box when installing against a standalone Tomcat server Foglight gets the default server name (localhost) and since there is no cluster or domain Foglight adds the agent to a system called UnclusteredTomcatHosts as displayed in this screen snapshot (click on the picture for a larger view).
The way to set a specific system name and a specific server name is with the parameter -Dquest.agent.appserverinfo
The usage of this parameter is this
set PERFORMASURE_OPTIONS=-Dquest.agent.appserverinfo=<Server Name>:<App Server Type>:<App Server version>:<Domain Name>
When using this option you can use some of these parameters as needed and let Foglight use the default for the rest.
For example if I want to put the agent under domain QATomcat and give the server the name Tomcat1 all I have to do is
set PERFORMASURE_OPTIONS=-Dquest.agent.appserverinfo=Tomcat1:::QATomcat.
I can also use variables from the OS, for example on windows I can use %COMPUTERNAME% if I want to give the Tomcat server the name of the machine it is running on
set PERFORMASURE_OPTIONS=-Dquest.agent.appserverinfo=%COMPUTERNAME%:<App Server Type>:<App Server version>:QATomcat.
This is an example of using the parameter, notice I put no values for application server type or version so Foglight can take the defaults.
And I get this result
The parameter works in a similar way for other app servers but is most commonly needed with Tomcat.
Hope you find this useful.
Golan Shem-Tov.