Install the PHP Agent

The CA APM PHP Agent provides monitoring visibility into PHP-based web application. The PHP Agent collects and reports detailed performance information about transactions in your PHP applications. The PHP Agent also collects and reports information about the system environment in which you run the PHP applications.
apmdevops106
The CA APM PHP Agent provides monitoring visibility into PHP-based web application. The PHP Agent collects and reports detailed performance information about transactions in your PHP applications. The PHP Agent also collects and reports information about the system environment in which you run the PHP applications.
  • The PHP Agent monitors and loads inside the PHP process and collects the application performance metrics. The PHP Agent sends the data to the Infrastructure Agent.
  • The Infrastructure Agent receives method start and end events from the Probe Agent, gathers timing data, and creates metrics. The Infrastructure Agent sends metrics and transaction trace snapshots to the Enterprise Manager.
    The Infrastructure Agent includes and uses a local installation of the Java Runtime Environment (JRE). A single Infrastructure Agent can handle multiple agent extensions Probe Agents.
As an administrator, use the procedures to install the PHP Probe Agent and the PHP Infrastructure Agent, and perform other optional tasks:
Perform these steps to plan for and begin your installation.
2
Complete the PHP Agent Installation Prerequisites
Before you install the PHP Agent components, ensure that your system meets these requirements:
  • Verify the system requirements.
    See the Product Compatibility Matrix.
  • System where you are installing the PHP Agent components has at least 500 MB of free disk space.
  • Supported Linux system with Apache and PHP supported versions that are installed.
Supported Server Environments and PHP Modes
This table shows the PHP implementation types that we support for several types of web servers.
Web Server Type
Apache (Prefork Mode)
Apache (Worker MPM Mode)
Other Web Server
PHP Implementation Type
mod_php
Yes
No
No
mod_fastcgid with php-fpm (FastCGI) (PHP-FPM (FastCGI Process Manager)
Yes
Yes
Yes
mod_fcgid with php-cgi
Yes
Yes
No
For PHP Probe Agent with Zend Thread Safety (ZTS) support, contact CA Support.
Download the Infrastructure Agent Software
The PHP Agent is delivered as part of the Infrastructure Agent. The Infrastructure Agent is available on CA Support.
Follow these steps:
  1. Go to CA Support.
  2. Select
    Product Downloads
    .
    The
    Download Management
    page opens.
  3. Search for
    CA Application Performance Management Agent
    .
  4. Click
    Product Downloads
    , and then search in the filter results for the following term:
    CA Application Performance Management PHP Agent MULTI-PLATFORM.
    Ensure the
    Release
    is
    10.7.0
    and the
    Service Pack
    is set to
    0000
    .
  5. Click the link for
    CA Application Performance Management PHP Agent MULTI-PLATFORM.
  6. In
    Component
    , search for
    Infrastructure Agent
    .
  7. Click the
    Cloud
    icon to download the GEN500000000000822.tar file and save it to your preferred location.
Install and Start the Infrastructure Agent
  1. Extract the contents of the Infrastructure-Agent-<version>-UNIX package file to the desired installation location. Use your operating system command to extract the file.
    tar xf APM-Infrastructure-Agent-<version>-unix.tar.gz
  2. Enable the PhpExtension. Open <
    Install_Home
    >/apmia/extensions/Extensions.profile in a text editor and add the PhpExtension to the profile:
    introscope.agent.extensions.bundles.load=PhpExtension
    Use commas to separate multiple monitor entries.
  3. Run the installation script:
    ./apmia-ca-installer.sh install
    The Enterprise Manager reports details about the Infrastructure Agent connection in its log.
    The Infrastructure Agent can be installed as root, super user or as a normal user. The installation script generates an entry in the crontab of the user that runs the script. Before you execute the script, ensure that the user has appropriate crontab permissions. See your operating system's documentation to find out how to set crontab permissions.
Infrastructure Agent Files
The Infrastructure Agent uses these files:
  • IntroscopeAgent.profile
    The PHP agent profile is located in the
    <
    Install_Home
    >/apmia/core/config
    directory.
  • Extensions.profile
  • The
    Extensions.profile
    file is located in the
    <
    Install_Home
    >/apmia/extensions
    directory.
  • bundle.properties
  • The
    bundle.properties
    file is located in the
    <
    Install_Home
    >
    /apmia/extensions/PhpExtension
    directory.
    The properties in the
    bundle.properties
    file can contain properties specific to the extension.
    bundle.properties
    can contain both dynamic (hot) and controlled (cold) properties. The controlled properties require application restart to take effect.
  • ProbeBuilder directives
    The PHP agent PBD files are located in the
    <
    Install_Home
    >
    /apmia/extensions/PhpExtension/directives
    directory. These files determine the PHP methods and classes that the PHP Agent can instrument.
    • PHP-toggles.pbd
    • PHP-common.pbd
    • PHP-sample.pbd
Select the Installation Method
Determine which one of these PHP Agent installer modes you want to use to install the PHP Agent:
  • Use silent mode when you want to install the PHP Agent from the command line and input optional arguments.In silent mode, you invoke the agent installer from a command line and specify inputs that contain installation instructions. The silent mode installer then runs in the background and requires no user interaction as it displays information about its progress. This installation method is most commonly used to install agents on remote computers or to install multiple agents with the same configuration.
  • Use interactive mode when you want to install the PHP Agent using a wizard-type installer.
Next step:
Or