---
title: Java agent browser monitoring settings
source: https://docs.newrelic.com/docs/apm/agents/java-agent/configuration/java-agent-configuration-browser-monitoring-settings
---

Browser monitoring settings control how the agent injects the browser agent snippet into your web pages.

> #### 💡 TIP
>
> Back to the full settings index: [Java agent configuration](https://docs.newrelic.com/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file)

## Browser monitoring [#Browser_Monitoring]

These options are set in the `browser_monitoring` section and can be [overridden](https://docs.newrelic.com/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file#System_Properties) by using a `newrelic.config.browser_monitoring` prefixed system property.

Browser monitoring gives you insight into the performance real users are experiencing with your website. This is accomplished by measuring the time it takes for your users' browsers to download and render your web pages by injecting a small amount of JavaScript code into the header and footer of each page.

**auto_instrument**

| Type    | Boolean |
| ------- | ------- |
| Default | `true`  |

By default the agent automatically inserts API calls in compiled JSPs to inject the monitoring JavaScript into web pages. Set this attribute to `false` to turn off this behavior.

**disabled_auto_pages**

| Type    | Comma-separated list of strings |
| ------- | ------------------------------- |
| Default | (none)                          |

When [`auto_instrument`](#bm-auto_instrument) is `true`, by default all pages are instrumented. List all pages that you want the auto instrumentation to skip here. You can still use manual instrumentation on these pages.

For example:

````yml
browser_monitoring:
  disabled_auto_pages: /WEB-INF/jsp/testpage_1.jsp, /WEB-INF/jsp/testpage_2.jsp
```

````

**attributes.enabled**

| Type    | Boolean |
| ------- | ------- |
| Default | `false` |

This setting can be used to turn on or off all attributes for browser monitoring. This is the [data you can query](https://docs.newrelic.com/docs/query-your-data/explore-query-data/explore-data/introduction-querying-new-relic-data). If `attributes.enabled` is false at the root level, no attributes will be sent up in browser monitoring regardless on how this property under `browser_monitoring` is set.

**attributes.include**

| Type    | List of Strings |
| ------- | --------------- |
| Default | (none)          |

If attributes are enabled for `browser_monitoring`, all attribute keys found in this list will be sent to New Relic in page views. For more information, see the [agent attribute rules](https://docs.newrelic.com/docs/apm/other-features/attributes/agent-attributes).

**attributes.exclude**

| Type    | List of Strings |
| ------- | --------------- |
| Default | (none)          |

All attribute keys found in this list will not be sent to New Relic in page views. For more information, see the [agent attribute rules](https://docs.newrelic.com/docs/apm/other-features/attributes/agent-attributes).