Instrumenting CA Spectrum as a Java APM application.

Document ID : KB000031123
Last Modified Date : 30/03/2018
Show Technical Document Details

The integration of Spectrum and APM is fully supported. This knowledge document covers how to instrument CA-Spectrum as a Java application.



The integration of CA-Spectrum to CA-APM can be easily done with the provided packages and the correct configuration.

On the other hand, if trying to instrument Spectrum as a Java application, some difficulties may arise on starting the Java agent.

The Spectrum installation includes an installation of Tomcat, which is where to configure the instrumentation.

After installing the Java agent, change the file IntroscopeAgent.profile to connect to the EM's IP address.

Place the startup parameters of the following line of catalina.bat ( for Windows ) or (for Unix/Linux).

set JAVA_OPTS=%JAVA_OPTS% -Djava.compiler=NONE -Xmx1024m -XX:PermSize=128M -XX:MaxPermSize=128M -XX:+HeapDumpOnOutOfMemoryError -server -Dfile.encoding="UTF-8"

After installing the Java agent onto the Spectrum server, modify the above line to look like this:
set JAVA_OPTS=%JAVA_OPTS% -javaagent:[PROPER_PATH]\wily\Agent.jar -Dcom.wily.introscope.agentProfile=[PROPER_PATH]\wily\core\config\IntroscopeAgent.profile -Djava.compiler=NONE -Xmx1024m -XX:PermSize=128M -XX:MaxPermSize=128M -XX:+HeapDumpOnOutOfMemoryError -server -Dfile.encoding="UTF-8"

Make sure that the path for the Java agent is correctly set, entering the character " before and after it, if the path contain spaces. Also do not
overlook that Java is case-sensitive, i.e., if the agent parameters are not entered right, then it will not work.

Assuming that the above is configured correctly, the Java metrics still will not show on the Investigator, as Tomcat is not called yet.

A call to "catalina start" (on C:\win32app\Spectrum\tomcat\bin for Windows and the equivalent for Unix/Linux) will show the Spectrum metrics on
the EM's Investigator as shown below.