Installation options

Scripts added before pa.js

Generally, the Plumbr browser agent needs to be included on the monitored web page before any other Javascript files. Otherwise, you will see an error message on your Plumbr account.

The reason for this is that in order to correctly capture user experience telemetry, the browser agent needs to run before any Javascript that adds its own event handlers or instrumentation – such as any frontend framework code (react, vue, angular, jquery, etc).

However, in some situations you might need to load scripts before pa.js that don’t infer with the Plumbr browser agent. In these circumstances you might want to disable the error message.

If you have just a few scripts, you can use data-plumbr-allow-before attribute.

Example

<script data-plumbr-allow-before src="loaded-before-browser-agent.js"></script>

<script src="https://browser.plumbr.io/pa.js"
    data-plumbr='{"accountId":"abcdef...","serverUrl":"https://bdr.plumbr.io"}'>
</script>

Alternatively, you can use a configuration propertydetectUnzoned, which will disable the check completely.

Example

<script src="https://browser.plumbr.io/pa.js"
    data-plumbr='{"accountId":"abc...","serverUrl":"https://bdr.plumbr.io", "detectUnzoned": false}'>
</script>

Note that this way, Plumbr browser agent will not check for being included as the first script on the web page. Use only if you know what you’re doing!