PHPackages                             gene/module-newrelic-rum-page-type - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging &amp; Monitoring](/categories/logging)
4. /
5. gene/module-newrelic-rum-page-type

ActiveMagento2-module[Logging &amp; Monitoring](/categories/logging)

gene/module-newrelic-rum-page-type
==================================

Track pageType in New Relic Real User Monitoring

1.0.4(1mo ago)15960↓62.5%LGPL-3.0-onlyHTMLPHP ~7.4.0||~8.1.0||~8.2.0||~8.3.0||~8.4.0||~8.5.0CI passing

Since Dec 3Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/genecommerce/module-newrelic-rum-page-type)[ Packagist](https://packagist.org/packages/gene/module-newrelic-rum-page-type)[ RSS](/packages/gene-module-newrelic-rum-page-type/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (4)Dependencies (3)Versions (7)Used By (0)

gene/module-newrelic-rum-page-type
==================================

[](#genemodule-newrelic-rum-page-type)

Install this module to easily monitor and improve customer experience by tracking [Core Web Vitals](https://web.dev/articles/vitals) in New Relic by page type and enhancing your [RUM](https://newrelic.com/blog/best-practices/what-is-real-user-monitoring) setup.

🎉 If you are hosted on Adobe Commerce Cloud you already have New Relic with browser monitoring available! 🎉

Why install it?
---------------

[](#why-install-it)

By default New Relic is already tracking LCP, INP, and CLS on page views. This is recorded and queryable within New Relic. However you can only filter by some default values like `domain` or `pageUrl`. This granularity is insufficient for tracking changes and making targeted improvements on your ecommerce site.

To be able to make impactful changes we need to tbe able to answer questions like

- What are customers experiencing on the whole domain?
- What are customers experiencing on product pages?
- What are customers experiencing in the checkout?

By adding this module you will have this level of detail and be able to make more informed decisions and stay ahead of any regressions.

Installation
------------

[](#installation)

```
composer require gene/module-newrelic-rum-page-type
bin/magento setup:upgrade

```

How it works
------------

[](#how-it-works)

This module adds a custom attribute to the New Relic PageViewTiming data to set the current request type as `pageType`.

This allows you to query the tracked data in segments like

- `cms_index_index` - the homepage
- `catalog_product_view` - product pages
- `catalog_category_view` - listings pages
- `checkout_index_index` - the checkout

How to use
----------

[](#how-to-use)

### 1. Prepare a New Relic dashboard

[](#1-prepare-a-new-relic-dashboard)

It is best to view this data within a New Relic dashboard. We have prepared a dashboard template for you to get started with

1. Copy the contents of `dev/new-relic-cwv-dashboard.json` into a text editor
2. Replace the dummy `1234567` account ID with your actual New Relic account ID
3. Replace `www.example.com` with your actual domain.
4. Log into New Relic
5. On the left panel click "Dashboards"
6. On the top right click "Import Dashboard"
7. Paste in the prepared JSON dashboard and import the "Core Web Vitals by PageType" dashboard.
8. You will now see a dashboard highlighting your Core Web Vitals.

This LCP/INP/CLS charts have a horizontal target line, your web vitals for desktop and mobile should be below this target line.

[![New Relic Dashboard showing core web vitals with pageType filter](dev/filter-by-pagetype.png "New Relic Dashboard showing core web vitals with pageType filter")](dev/filter-by-pagetype.png)

### 2. Deploy this module to production

[](#2-deploy-this-module-to-production)

1. Install this module on production. PageViewTiming metrics within New Relic will now have their `pageType` value attached.
2. Give it at least 24 hours for data to start filtering through, depending on your site and setup you may find patterns that some periods are slower when imports/exports are being triggered.

### 3. Make improvements for specific pageTypes

[](#3-make-improvements-for-specific-pagetypes)

1. When no filter is applied you can see the overall scores for your website, as well as other key pageTypes.
2. By filtering through `catalog_product_view`, `catalog_category_view`, etc you can identify areas for improvement and whether they are most significantly affecting desktop or mobile devices.
3. Use the [Chrome Performance Panel](https://developer.chrome.com/docs/devtools/performance/overview)
    1. Compare your experience to the experience of real users
    2. Configure your environment to better match that of the real users
    3. Investigate the additional panels, in particular the "rendering panel" can be very useful in improving CLS
4. After you deploy a fix it may take some time for it to become fully visible in your dashboard graphs.

### 4. Set up automated alerting

[](#4-set-up-automated-alerting)

1. After you have improved your web vitals you want to monitor them to prevent regression.
2. From the dashboard click `...` on the top right of CLS/INP/LCP
3. Create an alert condition
4. Follow instructions from

Tips

1. Alerting on a 24-hour rolling window seems to be the most stable.
2. Have an alert for desktop, and one for mobile.
3. Have alerts for specific page types, so that you are quickly alerted when something goes awry.
4. Alerts can fire even when no deployments are made, changes in audience, third party tracking, or A/B testers may be the cause.

Caveats
-------

[](#caveats)

New Relic RUM is not as complete as some other offerings, most notably it is missing [LoAF](https://support.newrelic.com/s/hubtopic/aAXPh0000007Zgz/browser-monitoring-interaction-to-next-paint-inp-loaf-support). However, if you already have New Relic and are not currently looking at your RUM data then this module may be enough to get you kick-started on that journey and making targeted improvements.

###  Health Score

51

—

FairBetter than 95% of packages

Maintenance93

Actively maintained with recent releases

Popularity26

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 90.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~135 days

Total

5

Last Release

37d ago

PHP version history (3 changes)1.0.0PHP ~7.4.0||~8.1.0||~8.2.0||~8.3.0

1.0.1PHP ~7.4.0||~8.1.0||~8.2.0||~8.3.0||~8.4.0

1.0.3PHP ~7.4.0||~8.1.0||~8.2.0||~8.3.0||~8.4.0||~8.5.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/aa904d0f61196b12bd6727175110ad7a58e19d888960279e7e4b9dbb636f34b9?d=identicon)[convenient](/maintainers/convenient)

![](https://www.gravatar.com/avatar/112fb744acca7c0c63cf0282b4f447d8f1c1703ea1330c115eb1a135435d17ff?d=identicon)[genecommerce](/maintainers/genecommerce)

---

Top Contributors

[![convenient](https://avatars.githubusercontent.com/u/600190?v=4)](https://github.com/convenient "convenient (20 commits)")[![cjnewbs](https://avatars.githubusercontent.com/u/1676494?v=4)](https://github.com/cjnewbs "cjnewbs (2 commits)")

### Embed Badge

![Health badge](/badges/gene-module-newrelic-rum-page-type/health.svg)

```
[![Health](https://phpackages.com/badges/gene-module-newrelic-rum-page-type/health.svg)](https://phpackages.com/packages/gene-module-newrelic-rum-page-type)
```

###  Alternatives

[graycore/magento2-stdlogging

A Magento 2 module that changes all logging handlers to stdout

2587.9k](/packages/graycore-magento2-stdlogging)[mage-os/module-admin-activity-log

The Admin Activity extension makes it easy to track all admin activity with comprehensive audit logging.

296.3k1](/packages/mage-os-module-admin-activity-log)[fredden/magento2-module-javascript-error-reporting

A Magento 2 module which captures JavaScript errors for later review by website administrators

3139.8k](/packages/fredden-magento2-module-javascript-error-reporting)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1860.2k](/packages/myparcelnl-magento)[graycore/magento2-graphql-logger

118.0k](/packages/graycore-magento2-graphql-logger)[mage-os/module-automatic-translation

Automatic AI content translation for Mage-OS.

3017.9k](/packages/mage-os-module-automatic-translation)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
