New Relic for PHP

The New Relic PHP agent monitors your application to help you identify and solve performance issues. You can also extend the agent's performance monitoring to collect and analyze business data to help you improve the customer experience and make data-driven business decisions.

APM > (selected app) > Overview: After installing the PHP agent, view a summary of your app's performance.

Compatibility and requirements

Before you install the PHP agent, ensure your system meets the system requirements.

The PHP agent supports many of the most common PHP frameworks, databases, and libraries.

Monitor app performance

View the big picture of your app

Find errors and problems quickly

Drill down into performance details

Analyze business data

Use the PHP agent with Insights to organize, query, and visualize your data to answer key questions about application performance and customer experience.

Install the agent

If you are installing the agent on a shared hosting service, ensure you have root permissions to install the agent or contact your hosting provider for technical assistance.

For standard installations, see:

For other types of PHP installations and advanced installation topics, see:

Configure the agent

The agent includes a variety of configuration options to further customize and fine-tune your installation.

The most important part of agent configuration is giving your app a unique name. New Relic uses this app name to aggregate metrics when you have multiple apps or servers.

After changing any agent configuration options, restart your web server.

Extend agent instrumentation

After installing the agent, go further and extend the agent's instrumentation:

  • Page load timing: Integrate the PHP agent with New Relic Browser to gain visibility into end-user activity.
  • Custom instrumentation: Instrument transactions not captured as part of our framework instrumentation.
  • Agent API: Use the agent API to customize the agent's behavior. For example, you can collect custom metrics, flag an error, or ignore a particular transaction entirely.
  • Agent attributes: Customize the attributes attached to transactions. Customizing attributes allows you to avoid sending sensitive attributes, or to collect additional attributes for deeper visibility into your transactions.

Troubleshoot your installation

If you encounter issues with the PHP agent, see our full list of troubleshooting documentation. Common installation issues include:

For more help

Additional documentation resources include:

Join the discussion about PHP in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at