Multi-monitor Configuration for PHP Applications

With multi-monitor configuration, you can separately monitor the performance of all individual applications running on the same app server, allowing you to assess your application performance at a granular level.

Let's say you have two PHP applications operating on your application server.

By default, the transactions of all applications coming from the same app server are shown collectively under APM > Transactions > Web.

For example, in the image below, PHP-APPLICATION is the name of the application monitor. There are two applications, cafe and tourism, running on the same application server.

You can see the transactions of these two applications in the Web Transaction tab shown below.


This means that enabling multi-monitor allows you to monitor the transactions of tourism and cafe independently.


To enable multi-monitor for Linux

  1. Log in to Site24x7. Navigate to APM > APM Insight.
  2. Download and install APM Insight PHP agent.
  3. Add the following key in the .htaccess file present in your application directory.
php_value zpa.application_name "APPLICATION_NAME"
  • APPLICATION_NAME can be any meaningful name.
  • Perform some transactions in the respective application to allow the agent to identify them as individual monitors.
  • When multi-monitor is enabled, each monitor is considered a separate APM application and each consumes an advanced monitor license.

To disable multi-monitor for Linux

To disable application-based monitoring, remove the following key from the .htaccess file present in your application directory. 

php_value zpa.application_name "APPLICATION_NAME”


To enable multi-monitor for Windows

  1. Log in to Site24x7. Navigate to APM > APM Insight.
  2. Download and install the APM Insight PHP agent.
  3. Navigate to the website's directory.
  4. Add the following configuration to the .user.ini file (The default file name is .user.ini, but it can have a different name) in the website's root directory.
    zpa_application_name="APPLICATION_NAME"
  5. You can find the setting below in your php.ini file.

    ;;;;;;;;;;;;;;;;;;;;
    ; php.ini Options ;
    ;;;;;;;;;;;;;;;;;;;;
    ; Name for user-defined php.ini (.htaccess) files. Default is ".user.ini"
    ;user_ini.filename = ".user.ini"

  • If you have a different file name instead of .user.ini, add the respective file name.
  • Perform some transactions in the respective application to allow the agent to identify them as individual monitors.
  • When multi-monitor is enabled, each monitor is considered a separate APM application and thus each consumes an advanced monitor license.

To disable multi-monitor for Windows

To disable application-based monitoring, remove or comment out the following key from the .user.ini file present in the application's directory. 

zpa.application_name="APPLICATION_NAME"

Keep in mind:

Background transactions are not shown for the individual monitor. The data is shown at the main application (PHP-APPLICATION) level.

This feature is available for APM Insight PHP Agent v3.2 and above.
Was this document helpful?
Thanks for taking the time to share your feedback. We’ll use your feedback to improve our online help resources.