Information:

Environment

PHP 7.0+ on Linux

AppMon 7.0

Symptoms

Failed switch PHP agent to one agent platform with error message like below:

PHP Startup: dtphpagent (bootstrap failed, see dtagent log for details): Unable to initialize module Module compiled with module API=0
Solution

Solution 1:

Install AppMon 7.1 agent and start up PHP agent with 7.1 bootstrap agent:

  • For 64 bit applications:
php.ini

extension=<agentFolder>/lib64/libdtagent.so

  • For 32 bit applications:
php.ini
extension=<agentFolder>/lib/libdtagent.so

 

Solution 2:

Step 1. Download one agent bootstrap file "liboneagentloader" by switching any other agents (Web Server, Java, Node.js, etc) to one agent.
Step 2. Manually add the agent name, agent location and collector address to php.ini file as below:

php.ini
phpagent.server=https://<appmonCollector>:<port>/
phpagent.agentname=<agentname>
extension=<agentFolder>/downloads/one/agent/7.0.x.x/linux-<architecture>/liboneagentloader.so



Root Cause

A bug in AppMon 7.0 bootstarp agent. Unfortunately bootstrapper is the part of the file system which can not be updated with product updates so fix is only available in AppMon 7.1+.