Our PHP agent auto-instruments your code so you can start monitoring applications. You can use our launcher, or follow the instructions in this document to complete a basic PHP agent installation.
Tip
To use PHP or any other agent, as well as the rest of our observability platform, join the New Relic family! Sign up to create your free account in only a few seconds. Then ingest up to 100GB of data for free each month. Forever.
PHP components
Our PHP agent consists of two basic components:
- A PHP extension, which collects data from your application
- A local proxy daemon, which transmits the data to New Relic
Your system's configuration components, including the web server, operating system, system permissions, PHP installation itself, package manager, etc., are all important factors during installation and configuration, because the agent is a part of that.
For more information about supported PHP releases, frameworks, and other system requirements, see PHP compatibility and requirements.
Install the agent
Follow this general process to install the agent on your system. The agent installation package or tar archive includes the interactive newrelic-install
script, which automates some installation tasks.
Tip
If your application is frequently inactive, we recommend you generate some data by interacting with the application or site. This will help ensure the agent initially connects.
Ensure your system meets the agent's requirements, including appropriate system permissions.
If you do not already have a New Relic account, create one.
From your Account settings, copy your license key information.
Install the agent package or tar archive on your system.
Change the default application name to a meaningful name.
Optional: Change other agent configuration settings to further customize your installation.
Restart your web server (Apache, Nginx, PHP-FPM, etc.).
Recommendation: To help ensure the PHP agent is initiated, especially if your application has infrequent activity, generate some data by using the app for a few seconds.
Wait a few minutes for your application to send data to New Relic.
Then, check your app's performance in the New Relic UI.
Install PHP with partnership accounts
Installation procedures may be different for admins who install the PHP agent through a New Relic partnership. For more information, see:
Not all partners support PHP agents.
For more help
If you need more help, check out these support and learning resources:
- Suggest a change and learn how to contribute to our PHP agent open source repository.
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.