On this page:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
17 rates

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

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.

agent.controller.hostName

This is the host name or the IP address of the AppDynamics Controller. Example values are 192.168.1.22, myhost or myhost.abc.com. 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.

agent.controller.port

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.

agent.applicationName

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.

agent.tierName

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

This setting is required.

agent.nodeName

This is the name of the instrumented node.

This setting is required.

agent.accountName

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.

agent.accountAccessKey

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.

agent.controller.ssl.enabled

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.

agent.proxy_ctrl_dir

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