Connecting Cloud APM agents to Monitoring server

To connect Cloud APM agents to Monitoring server, you must first locally apply an agent patch to update the agent framework and then configure the agent for server connection.

Before you begin

About this task

Diagnostics and transaction tracking data are not yet supported by Monitoring. If the V8 agents have been enabled for diagnostics and/or transaction tracking data collection, they will be disabled during the following procedure.

Procedure

  1. Extract the agent patch to the local system where the V8 agent is installed.

  2. From the extracted directory, run the following command to apply the patch:

    ./apmpatch.sh

    apmpatch.bat

    Note: If the Cloud APM agents to be connected are not installed in the default directory(/opt/ibm/apm/agent on Linux and AIX®, C:\IBM\APM on Windows), you must add the installation path install_dir to the command:

    ./apmpatch.sh install_dir

    apmpatch.bat install_dir

    The patch will be applied for IBM Monitoring Shared Libraries and IBM GSKit Security Interface.

  3. If the V8 agents have been enabled for diagnostics and/or transaction tracking data collection, reconfigure the V8 agents to disable them.

    For more information about how to reconfigure the V8 agent, see the IBM Cloud APM Documentation.

  4. Download the agent configuration pack from the IBM Cloud Pak console. The downloaded package contains agent configuration files for server connection.

    1. Log in to the IBM Cloud Pak console and click Get Started.
    2. Go to Administer > Monitoring > Integrations > New integration on the IBM Cloud Pak console.
    3. In the Standard monitoring agents section, go to the APM V8 Agents tile and click Configure.
    4. Click Download file to download the ibm-cloud-apm-v8-configpack.tar file.

  5. Extract the .tar file to the system where the V8 agents are installed. In the extracted directory, the .tar file is for the Linux and UNIX systems, while the .zip is for all Windows systems. Use the appropriate file in the following steps according to your operating system.

  6. To configure the V8 agent for a Monitoring server connection, extract the .tar and run the post\_config script with the -i and -e options as the user who installed the V8 agent. Use the -i option to specify the agent installation directory and use the -e option to specify the path to the env.properties file in the extracted directory.

    ./post_config.sh -i agent_install_dir -e env.properties

    post_config.bat -i agent_install_dir -e env.properties

    where agent_install_dir is the V8 agent installation directory.

  7. (WebSphere® Applications agent only) If the V8 agent has been enabled for diagnostics and/or transaction tracking data collection, they have been disabled now. Restart the application server for the data collector to update the configuration.

Results

All V8 agents installed on the same system are configured to connect to the Monitoring server. However, you can view monitoring data only for the supported agents on the IBM Cloud Pak console.

What to do next