1. 📊 Introduction: Go Beyond Lab Tests

The JaJuMa Real User Monitoring (RUM) extension for Magento 2 provides critical, real-time insights into your store’s performance and stability as experienced by your actual visitors. It moves beyond theoretical lab tests to capture the real-world data that directly impacts your revenue and search engine rankings.

A fundamental concept in web performance is the difference between "Lab Data" and "Field Data." Lab data, generated by tools like a local Lighthouse audit, simulates a user's experience under a specific set of conditions.
While useful, it cannot capture the vast diversity of real user environments, network speeds, and device capabilities. Field Data, on the other hand, is aggregated from actual user sessions.

This is the data that Google uses for its search ranking algorithms and is the truest measure of your site's performance.
This extension is the definitive tool for capturing and analyzing Field Data for your Magento store, allowing you to optimize the three core pillars of user experience: Core Web Vitals (CWV), frontend stability, and overall perceived speed.

1.1 💻 What Problems Does This Extension Solve?

This extension is engineered to solve the most pressing performance and stability challenges faced by Magento store owners and developers:

• Problem: You're guessing about your store's real performance.
  Solution: Stop relying on simulations. Get actionable, real-world data on key metrics like Largest Contentful Paint (LCP), Cumulative Layout Shift (CLS), Interaction to Next Paint (INP), and Time to First Byte (TTFB).
  See exactly what your customers see and identify the true bottlenecks holding back your store.

• Problem: Frontend JavaScript errors are silently affecting users and sales.
  Solution: Proactively capture all frontend JS errors with full stack traces and user context.
  This allows your development team to identify and fix bugs before they escalate, leading to a more stable user experience and preventing lost sales.

• Problem: You need to improve SEO and conversion rates but don't know where to start.
  Solution: A faster, more stable site directly correlates with lower bounce rates, higher conversion rates, and better search engine rankings.
  This extension provides the precise data needed to focus your optimization efforts where they will have the most impact on your bottom line.
  → Calculate Your Page Speed ROI.

• Problem: You are concerned about data privacy and recurring SaaS fees.
  Solution: As a self-hosted, local solution, this extension gives you 100% data ownership.
  No data is sent to third parties, ensuring full GDPR compliance.
  A one-time payment eliminates the unpredictable and costly monthly fees associated with external RUM services.

1.2 🎯 Key Features at a Glance

The extension provides a comprehensive toolset for performance monitoring and analysis:

• Data Collection:
  A lightweight, asynchronous tracking script with configurable sampling to manage data volume on high-traffic sites.
• Data Processing:
  Advanced options to enrich data with country-level geocoding, filter out bots via IP and User-Agent blacklists, and ensure user privacy with IP anonymization.
• Automation:
  Fully automated data processing and cleanup via configurable cron jobs, including a critical server load safeguard to protect your production environment during peak traffic.
• Reporting:
  A powerful and intuitive RUM Dashboard integrated into the Magento backend, featuring global filters, historical trend charts, daily breakdowns, and deep-dive detail views.
• Developer Tools:
  Full Command Line Interface (CLI) support for manual data processing and cleanup, enabling easy integration into CI/CD workflows.

1.3 💡 Expert Insight: A Note on Data Processing & Server Resources

The average Magento extension is 'set and forget.' However, a powerful Real User Monitoring tool like ours performs serious data processing in the background to ensure your reports are fast, responsive, and rich with detail.

To ensure that most stores can leverage this power without commissioning additional hardware, we've engineered the extension with extensive flexibility and optimization controls:

• Data Sampling: Reduces the volume of data that needs to be processed.
• Configurable Reporting: Tailor the depth of your reports (e.g., global-only vs. per-store-view) and exclude dimensions you don't need.
• Multi-Threading: Control the number of CPU cores dedicated to data processing.
• Off-Peak Scheduling: Move intensive processing tasks to low-traffic periods, like overnight.
• Server Load Safeguard: Automatically pauses processing if your server load exceeds a pre-configured threshold, always prioritizing your customers.

While these features make our RUM tool highly efficient, it's important to note: stores with extremely high traffic or servers that are already operating at maximum capacity may need to ensure they have adequate resources for smooth data processing.

1.4 📝 How This Documentation is Structured

This documentation is designed to be a complete resource for users of all skill levels.

• New Users: Start with our Quick Start Guide to get the most impactful features running in minutes.
• All Users: The Configuration sections provide a deep dive into every setting, broken down by function:
  • General Configuration
  • RUM Data Collection Configuration
  • RUM Data Processing & Privacy Settings
  • Automation & Cron Jobs
• Usage & Analysis:
  • Using the RUM Dashboard for Analysis
• Developers & Advanced Users:
  • CLI & Maintenance
  • Troubleshooting and Frequently Asked Questions

1.5 📱 How To Navigate The Extension in Magento

You can access all features of the Real User Monitoring extension directly from your Magento Admin backend menu.

• JaJuMa -> Real User Monitoring -> RUM Dashboard
  To access the main reporting interface. (For details see section Using the RUM Dashboard for Analysis)

• JaJuMa -> Real User Monitoring -> Configuration
  To access all configuration settings, organized into five sections:

  • General
  • RUM Data Collection Configuration
  • RUM Data Processing & Privacy Settings
  • Automation / Cron Jobs
  • Maintenance

Alternatively, you can access the dashboard via the main Magento Dashboard menu:

• Dashboard -> Real User Monitoring -> RUM Dashboard

📞 Need Help?

Still have questions or need help with your configuration? Our expert team is here to assist. Please don't hesitate to contact our support team for personalized assistance.