The PHP installers write information that the agent uses to communicate with the Controller to the AppDynamics Agent section of the PHP configuration files.

By default, the PHP Agent marks an HTTP error response, such as status code 4xx response as an error. When the following setting is added to the php.ini file, it will not mark the HTTP error response as an error.

agent.http_error_detection = false

This is different from some of the other AppDynamics application agents, which write this information to an XML file called controller-info.xml.

If you re-install the agent, the installer overwrites your settings only if you are using a fragments directory. It never overwrites the php.ini file. You can edit the PHP configuration files after installation to add, delete or modify these settings.

If a setting documented as required is not provided, the agent will not start. In this case, the agent logs the error to the web server error log. For example, if the controller.Hostname is not set you would see the following message in the Apache error log:

[AD agent] agent.controller.hostName is not set. Agent is disabled.

If after successful startup you remove a required setting or set it to an empty value, the change is ignored as long as the application is running, using the original value of the setting as it was at startup. If you change a required setting to a different valid value, restart the web server to apply the change.

The Controller information settings are described below:


This is the host name or the IP address of the AppDynamics Controller. Example values are, myhost or This is the same host that you use to access the AppDynamics browser-based user interface. For an on-premises Controller, use the value for application server hostname that was configured when the Controller was installed.

This setting is required.


This is the HTTP(S) port of the AppDynamics Controller. This is the same port that you use to access the AppDynamics browser-based user interface.

If agent.controller.ssl.enabled is true, specify the HTTPS port of the Controller; otherwise, specify the HTTP port. See agent.controller.ssl.enabled.

For on-premises installations, port 8090 for HTTP and port 8181 for HTTPS are the defaults. 

This setting is required.


This is the name of the logical business application that the instrumented node belongs to.

If a business application of the configured name does not exist, it is created automatically.

This setting is required.


This is the name of the logical tier that this node belongs to.

This setting is required.


This is the name of the instrumented node.

This setting is required.


This is the account name used to authenticate with the Controller.

This setting is required if the AppDynamics Controller is running in multi-tenant mode or if you are using the AppDynamics SaaS Controller. It specifies the account name for the agent to use to authenticate with the Controller. If you are using the AppDynamics SaaS Controller, the Welcome email sent by AppDynamics provides the account name.

This setting is not required if the Controller is running in single-tenant mode.


This is the account access key used to authenticate with the Controller.

This setting is required. To find your access key, click the gear () icon in the upper right corner of the AppDynamics UI, then click License.


When set to true, this setting specifies that the agent should use SSL (HTTPS) to connect to the Controller. If agent.controller.ssl.enabled is true, set the agent.controller.port to the HTTPS port of the Controller.


This specifies the initial control communication directory between the agent and the proxy. Needed only for a manual proxy start. See Start the PHP Agent Proxy Manually


When you add this setting to the php.ini file in the PHP Agent, you can set a unique host ID for the App agents.

agent.uniqueHostId = <Insert uniqueHostId>

For example, agent.uniqueHostId =  AppDynamics


When adding this setting to php.ini, the PHP agent, marks HTTP error response, such as status code 4xx response as an error.