PHP Troubleshooting Framework Install

Once you’ve installed the PHP agent, you should see data reporting within a few minutes. If you’re having trouble, these are the steps that our support teams take to troubleshoot, and we hope they will help you find and resolve the issue quickly.

  1. Confirm the app is receiving traffic, has been for at least 5 min, and continues to receive traffic during troubleshooting.

  2. Run the Diagnostics CLI to collect data then validate the following…

    1. Confirm PHP version & OS is supported.
    2. Confirm root access for installation.
    3. Verify the newrelic.ini file is read by checking phpinfo() page.
    4. Verify if the agent is loaded by checking the phpinfo() page. Note that phpinfo() can be related to the Web Interface as well as CLI Interface.
    5. Verify two newrelic-daemon processes are running.
    6. Check for High Security Mode configuration mismatches.
  3. Check for Non-Standard PHP. PHP that is self-compiled or used as part of a hosting service might not be found by our installer. Use advanced installation steps for this scenario.

  4. Check if SELinux is enabled as it might interfere with the agent -> daemon communication. Configure SELinux to work with the agent.

  5. Check phpinfo() and confirm the license_key displayed there matches the expected account license key.

  6. Confirm is installed correctly and visible in the phpinfo() page. If not, follow this procedure.

  7. If using Apache Threaded MPM Workers look into using supported alternatives as outlined in this document.

  8. Check the log files are generated in /var/log/newrelic/*, if not follow the suggested solutions from this document based on what you see in the logs.

  9. If you are still unable to resolve the issue please reach out to New Relic Global Technical Support by going to Please be sure to mention, in as much detail as possible, the steps you have tried already and details of what you expect to see and what you are seeing.