PHP Monitoring
How to change the configuration in PHP after installing the S247DataExporter
Linux Modify the configuration.json file located in the /opt/S247DataExporter/conf directory. Windows Modify the configuration.json file located in the <installation path>\S247DataExporter\conf directory. The default installation path is C:\Program ...
How to set the PHP path during agent installation?
This is only applicable to the agent versions 4.2 and above. For Linux Step 1: Download the installation script. wget -O InstallAgentPHP.sh https://staticdownloads.site24x7.com/apminsight/agents/AgentPHP/linux/InstallAgentPHP.sh Step 2: Set your PHP ...
DC migration steps for APM Insight PHP agent
PHP Windows agent Obtain the new device key. Update the license.key value in the apminsight.conf file located at <INSTALLPATH>\APM Insight PHP Agent\zpa\bin. Log in to the server and delete the existing instance information file instance.out located ...
How to enable or disable method tracking in the PHP agent?
To enable method tracking, set the "zpa.track_zend_execute" and "zpa.track_zend_execute_internal" directive to "1" in the zpa.ini (Linux) or php.ini (Windows). Similarly, to disable, set to "0." To enable method tracking: Internal (built-in) ...
How to enable or disable exception tracking in the PHP agent?
To enable exception tracking, set the "zpa.track_exceptions" directive to "1" in the zpa.ini (Linux) or php.ini (Windows). Similarly, to disable, set to "0." To enable error tracking: zpa.track_exceptions = 1 To disable error tracking: ...
How to enable or disable error tracking in the PHP agent?
To enable error tracking, set the zpa.track_errors ini directive to 1. Similarly, to disable it, set it to 0. To enable error tracking: zpa.track_errors=1 To disable error tracking: zpa.track_errors=0 Refer to this document on how to modify the PHP ...
How to deploy the Site24x7 PHP agent in a Kubernetes environment?
For PHP version 7.0 and above The PHP agent (PHP version 7.0 and above) can be deployed in a Kubernetes environment using any of the following methods. You can also keep the license keys in a configmap to avoid using them in the deployment files. The ...
How to enable and disable distributed tracing in PHP applications?
To enable distributed tracing, set the "zpa.capture distributed trace" directive to "1" in the zpa.ini (Linux) or php.ini (Windows). Similarly, to disable, set to "0." To enable distributed tracing: In the zpa.ini (Linux) or php.ini (Windows), ...
How to modify the APM Insight PHP agent's communication port?
The agent uses ports 20021 and 20022 by default. You can change these ports by modifying the appropriate directive in the zpa.ini file (Linux) or php.ini file (Windows), as well as in the apminsight.conf file (Linux and Windows). Default ...
How to configure the number of method calls to be tracked in the trace details in PHP applications?
The first 1000 methods that exceed the method threshold are tracked by default, after which only the external calls are tracked. You can modify this by changing the zpa.additional_buffer directive in the zpa.ini (Linux) or php.ini (Windows). Default ...
How to configure the stack depth of traces in PHP applications?
The default stack depth of traces is 15. You can change this by modifying the zpa.stack_depth directive in the zpa.ini (Linux) or php.ini (Windows). Default configuration: In the zpa.ini (Linux) or php.ini (Windows), zpa.stack_depth = 15 Note: The ...
How to customize instrumentation in PHP agent?
By default, the following components are tracked: CASSANDRA, CURL, MSSQL, MYSQL, ORACLE, PDO, and POSTGRES. These can be individually enabled or disabled by modifying the corresponding ini directive in the zpa.ini (Linux) or php.ini (Windows). ...
Ignore transactions from monitoring
To ignore or drop transactions from monitoring by the APM Insight PHP agent, follow the below-given steps. Install APM Insight PHP agent in your application and add a configuration file /opt/zpa/conf/transaction_drop_patterns.conf Add transaction ...
Error while loading shared libraries: libcurl.so.4: cannot open shared object file: No such file or directory
APM Insight PHP agent requires libcurl to be available in the default library directories, like /usr/lib. However, if libcurl is not installed on the system, the agent can use the library in the /opt/zpa/lib directory. To enable the agent to use the ...
Automatically restart APM Insight PHP agent during system reboots
To automatically restart APM Insight PHP agent during system reboots, use the below given steps: For systemd servers: From APM Insight PHP agent version 2.8, agent will automatically start during server reboots for systemd supported Linux flavors. ...
Reconfigure APM Insight PHP agent during PHP version upgrade
If you have upgraded your PHP version and face problems in monitoring after the upgrade, here's how you can resolve it. In general, APM Insight PHP agent registers with the PHP version present in the server at the time of installation. So when you ...
How to add a PHP instance that was deleted earlier
For agent versions 4.0 and above For every instance, there will be a corresponding configuration file present inside the conf folder of the S247DataExporter installation path. Delete the appropriate configuration file and restart the S247DataExporter ...
Customize URL names using PHP agent API
With APM Insight PHP agent, you can customize URL names for your web transactions. Here's how you can do it: Open the PHP script of the transaction for which you want to customize the URL. Add the following snippet in any part of the PHP script ...
Troubleshooting steps if you don't see any data after installing the PHP agent
Problem statement: The APM Insight PHP agent has been installed, but no data is displayed in the Site24x7 web client. Troubleshooting steps: Ensure that you have installed both the PHP agent and the S247DataExporter. Check that you have restarted the ...
What do I do if my web server crashed after installing PHP agent
Stop the agent and send the logs to technical support. In order to stop agent : Login as root with command <sudo -s> and enter password. Navigate to zpa/bin directory and execute command <sh run.sh stop>
Error : GLIBC 2.14 not found (required by ./installer)
It means that the downloaded PHP agent was built with GLIBC 2.14 version, and it requires that version. Your system has an older version of GLIBC installed and hence you face this error. PHP agent built with older version of GLIBC can be downloaded ...
Methods to upgrade PHP agent (Linux/Windows)
PHP agent can be upgraded in 2 ways: Auto upgrade Manual upgrade Auto upgrade: When this feature is enabled, the latest version of the agent is automatically downloaded and deployed when it is made available After the deployment process is complete, ...
Deploying PHP Agent in AWS EC2 Beanstalk
Please check this help page for instructions on how to install the PHP agent in EC2 Beanstalk.
Troubleshooting steps to check if installation of PHP has been done properly
Please check if the below steps have been performed to successfully install PHP: Create a sample .php file within your web application that contains the following: <?php phpinfo();?> Navigate to this page in a web browser and scroll through the ...
Frameworks supported for PHP monitoring
We currently support the following application frameworks: Codeigniter, CakePHP, Laravel, Drupal, Joomla, WordPress, Magento, and Symfony. To know more about PHP agents, refer here.
Prerequisites to install PHP agent
To install PHP agent on your machine, ensure that the following prerequisites are met: 1. Your machine must be running either on Linux or Windows OS. 2. You need to have Apache 2 Web Server or any other FPM based web server. 3. PHP 5.3 or above. To ...