Setting Up RUM with PHP
  • 14 Jan 2021
  • 1 Minute To Read
  • Contributors
  • Print
  • Share
  • Dark
    Light

Setting Up RUM with PHP

  • Print
  • Share
  • Dark
    Light

This document details how to enable RUM for the APM Profiler in your PHP application running on Linux or Windows.

Prerequisites

1. Install the Latest Version of the Agent

PHP on Windows is currently not supported

Required Agent Version
  • Linux Agent v2.30.10+
  • PHP Profiler 1.11.18 (currently in beta) or 1.10.10
    Note: If using the v1.10.10 profiler, you will need to add the following to the [Stackify] section of the php.ini:
stackify.rum_enabled=1

2. Enable RUM and Implement the JavaScript Snippet

Follow the RUM Getting Started guide to Enable RUM on your account and Implement the JavaScript Snippet into the HTML of the application.

3. Setup APM for your Application

Follow the PHP Getting Started Guide to configure the profiler for your specific setup. The profiler will need to be properly configured for RUM to function.

4. Redeploy your App

Once the previous steps to enable RUM for your account and add the code snippet to your app(s) have been completed, the last step is to deploy the changes to your application.

Viewing RUM Data

Once the following steps have been taken to set up RUM for your apps, data will be reported in the corresponding App Dashboard. To see more information related to what RUM data is presented in the App Dashboard, see the Viewing RUM Data in Retrace help doc.

Disabling the RUM Cookie

By default, the profiler generates a cookie used by RUM to calculate page timings on your monitored applications. In rare edge case scenarios, this cookie can cause issues with page caching. If you experience this, follow the steps below to disable the RUM cookie:

stackify.rum_enabled=0

Example:

[stackify]
extension=stackify.so
stackify.application_name=My PHP Application
stackify.environment_name=Production
stackify.rum_enabled=0
Was This Article Helpful?