Multi-monitor Configuration

Overview

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-APP is the name of the application monitor. There are two applications, php-app-one and php-app-two, running on the same application server. You can see the transactions of these two applications in the Transactions tab shown below:

This means that enabling multi-monitor allows you to monitor the transactions of php-app-one and php-app-two independently.

Note: Currently, this feature is available only for PHP and .NET agents alone.

Enabling multi-monitor configuration

Windows

  • Log in to Applications Manager. Navigate to APM Insight page by clicking over APM tab.
  • Download and install the APM Insight PHP agent for Windows.
  • Navigate to the application's directory folder.
  • Add the following key in 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"

  • 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"

Note:
  • 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 separate monitor license.

Linux

  • Log in to Applications Manager. Navigate to APM Insight page by clicking over APM tab.
  • Download and install the APM Insight PHP agent for Linux.
  • Add the following key in the .htaccess file present in your application directory:

    php_value zpa.application_name "APPLICATION_NAME"

Note:
  • 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 separate monitor license

Disabling multi-monitor configuration

Windows

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

zpa_application_name="APPLICATION_NAME"

Linux

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

php_value zpa.application_name "APPLICATION_NAME"