History: Real User Measurement

            {syntax type="markdown"  editor="wysiwyg"} # {{page}}

New in ((Tiki24))

# What?

Real User Measurement A.K.A End-User Experience Monitoring, is a form of passive monitoring that records user interaction with a website. In other words, Real User Measurement monitors performance by collecting data about user interactions with an app.

# Why?

Actually, users' experience with your website determines whether they will use your website or not. If for example, your website is slow, difficult to understand, or down, the risk of losing visitors increases. That's where Real User Measurement comes in and becomes very important as it can help you catch what users experience.

# In Tiki

In Tiki, this feature reuses a JavaScript library called [https://github.com/akamai/boomerang|boomerang] that measures the page load time experienced by real users. With this feature, you find out exactly how fast your users think your site is. 
Apart from page load time, boomerang can measure performance timings, metrics, and characteristics of your user's web browsing experience (But this is not implemented in Tiki yet).

## How it works

In order to experience this feature in Tiki, you need to be an admin (obviously), to be able to visit the performance page. 
But in order to view the needed details there is just one thing you need to take care of: **Enabling the Tiki Performance feature**.

## How to enable

To enable this feature you go to ***Settings -> Control Panels -> Advanced -> Performance***, and under the ***Performance*** tab, locate the ***"Monitor Tiki Performance"*** feature, activate it, and hit the "***Apply***" button. 
{img src="display1941" link="display1941" width="600" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border" alt="enable performance feature"}

## How to test

Finally, to test if things work as expected, visit any page/URL in Tiki and open the performance page that can be found under Settings, 
{img src="display1943" link="display1943" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border" alt="link to performance page"} 
Or by visiting "***/tiki-performance_stats.php***", you will find two tables as shown in the figure below, one showing the average time taken by a request and another one the maximum time taken by a request 
{img src="display1942" link="display1942" width="600" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border" alt="performance stats page"}

---

*Just for information purposes, you can install a browser extension which provides much of the same info: https://github.com/alex-vv/page-load-time/blob/master/README.md#where-to-install-from*

Related:

Performance 
https://akamai.github.io/boomerang/ 
Initial merge requests: 
https://gitlab.com/tikiwiki/tiki/-/merge_requests/831 
https://gitlab.com/tikiwiki/tiki/-/merge_requests/832