Plumbr Browser Agent: Alpha

What is Plumbr Browser Agent?

Plumbr Browser Agent enables Plumbr to monitor end user interactions in web-based applications as they occur in the end user browser.

Browser Agent is a tiny script tracking the traffic leaving the user’s browser and linking this traffic with specific user-initiated events (such as clicks or keystrokes).

As a result of this, it is possible to track the entire user journey in your web application and see how your end users really experience your digital assets.

How to install?

Adding Plumbr Browser Agent is as easy as copy pasting the following script tag to your page. The only change you need to make is to replace plumbrAccountId with your actual account id.

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

Due to technical reasons it is required that the script tag is added in the head tag before any external resources, e.g. scripts or css files. For example, if we had the following page:


<head>
	<meta charset="utf-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
	<meta name="viewport" content="width=device-width, initial-scale=1">
	<title>Plumbr</title>

	<link rel="stylesheet" href="/gfx/main-984b41d423.css">
	...
</head>

Then after adding Plumbr script it would look like:


<head>
	<meta charset="utf-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
	<meta name="viewport" content="width=device-width, initial-scale=1">
	<title>Plumbr</title>

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

	<link rel="stylesheet" href="/gfx/main-984b41d423.css">
	...
</head>

What is the overhead?

To be frank, we cannot give you a meaningful answer just yet. In-house tests have been concluded with more than 1,000 different applications with barely noticeable overhead from end user perspective.

We are still working on building a reasonable test set to be able to give a measurable and specific answer about the incurred overhead.

What Browsers are supported?

Plumbr Browser Agent works with every modern browser. The list of officially supported browsers includes

Plumbr Browser Agent is known not to work with several outdated browsers (such as for example Internet Explorer 6). In case our Browser Agent cannot perform its work due to an unsupported browser, the Agent functionality is not activated and the application will still function, just no data will be gathered.

What types of web applications are supported?

Plumbr Browser Agent supports both traditional web applications and single page applications. The support for both types is not framework-specific, so independent of whether you are using jQuery, Angular, React or any other Javascript library, our Browser Agent should just work. However, the following technologies are not supported at the moment:

What data does it gather?

Browser Agent captures every outbound request from the browser. In addition, the Agent captures certain user interactions with the application interface. Such actions includes mouse clicks and keyboard strokes.

Most of the captured user interactions are not however sent to the server to be analyzed. Only the user interactions triggering at least one request from the browser will end up being sent to the server.

What the Agent does NOT capture: