Using the Azul Intelligence Cloud Agent
The Intelligence Cloud Agent is the prefered way to connect your Java Virtual Machine (JVM) with the Forwarder to send all the required data to your Intelligence Cloud instance. The Intelligence Cloud Agent is designed for wide compatibility and doesn’t conflict with natively-supported versions of the Azul JVM.
Provided Features
By using the Azul Intelligence Cloud Agent, your JVMs will send the required data to be able to use all the features provided by Intelligence Cloud.
Supported Platforms
The Azul Intelligence Cloud Agent is supported for Java 8 and newer and is independent of the Operating System or CPU architecture.
Installation and Usage Instructions
-
Download the latest version of the Azul Intelligence Cloud Agent.
-
You can check ic-agent.json for a list of available downloads.
-
You can also download the agent from the Web UI > Settings > Agent.
-
-
Put the agent to an easy to locate directory on the systems where you run your Java applications, e.g.
/opt/azul-ic-agent/. In the following examples, this directory is referred as${AGENTDIR}.
Configure Security Manager
Most Java applications do not use the SecurityManager, which was deprecated in Java 17. Some older applications that use the SecurityManager may need the following policy configuration:
grant codeBase "jar:file:${AGENTDIR}/ic-agent.jar!/" {
permission java.security.AllPermission;
};
Export Agent in Startup Options
Export the following startup options on your runtime environment to attach the Intelligence Cloud Agent to your application.
export JDK_JAVA_OPTIONS="-javaagent:${AGENTDIR}/ic-agent.jar \
-DaagentDir=${AGENTDIR} \
-Djava.security.policy=${AGENTDIR}/agent.all.policy"
|
Note
|
This will start the IC Agent on every start of the JVM. In case you are running your application and the Forwarder on the same machine, this approach is not recommended. |
You can configure the behaviour of the agent further in detail, see CRS Arguments.