Single or Multi-Tenant

For the PHP agents, the proxy can be single-tenant (one proxy per agent) or multi-tenant (multiple agents communicating through a single proxy), depending on the way the agents are configured. The default setup for these agents is single-tenant, but there are circumstances for which a multi-tenant proxy is required or desirable. The Apache Web Server and Python agents always communicate through a multi-tenant proxy when there are multiple agents on a machine.

Automatic or Manual Startup and Shutdown

Typically the proxy is automatically started when the application agent starts up, but in some cases, you need to launch it manually. These cases vary depending on both the particular agent and the application environment.

After the proxy is started (automatically or manually) it registers with the Controller and requests the agent configuration. The agent must receive the configuration from the Controller via the proxy before it can report metrics.

If the proxy was automatically started, the agent is supposed to shut down the proxy as part of its own cleanup procedures. If the proxy was manually started, it must be shut down manually.

Proxy Logs

If the proxy is running, you can check the proxy log to examine connection issues.

The proxy log files are named proxy.<timestamp>.log.

If the proxy is not running, examine the agent logs for the typical Java startup signature to see if the proxy started.

See the agent-specific documentation for the location of these logs:

• PHP: Default is <php_agent_install_dir>/logs. See Install the PHP Agent.
• Python: Default is /tmp/appd/logs. See Python Agent Debugging and Logging.
• Web Server: <webserver_agent_install>/logs/proxy_$date.logs. See Apache Agent Logging.