---
title: Auto-Instrumentation
description: >-
  Automatically inject RUM Browser SDK into HTML responses through web server or
  proxy configuration.
breadcrumbs: >-
  Docs > RUM & Session Replay > Application Monitoring > RUM Browser Monitoring
  > Browser Monitoring Setup > Auto-Instrumentation
---

# Auto-Instrumentation

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com



{% alert level="danger" %}
RUM Auto-Instrumentation is not available for the selected site (). Use [Client-Side instrumentation](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/setup/client) instead.
{% /alert %}


{% /callout %}

## Overview{% #overview %}

RUM Auto-Instrumentation allows you to add RUM JS to your web app HTML. It works by injecting the RUM Browser SDK into the HTML responses being served through a web server or proxy. After auto-instrumentation is set up, you can manage configurations from the UI.

RUM Auto-Instrumentation requires Datadog Agent version 7.34+.

## Getting started{% #getting-started %}

Select a platform to start collecting RUM data on your application:

{% alert level="info" %}
To request support for a web server that is not listed here, [fill out this form.](https://www.datadoghq.com/private-beta/rum-sdk-auto-injection/)
{% /alert %}

- [java_servlet](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/setup/server/java)
- [nginx](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/setup/server/nginx)
- [windowsiis](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/setup/server/windows_iis)
- [apache](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/setup/server/apache)
- [ibm](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/setup/server/ibm)

## Limitations{% #limitations %}

Auto-instrumentation for this server has the following limitations. If your use case requires more control, use [client-side instrumentation](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/setup/client) instead.

- This instrumentation method **does not support [advanced RUM configurations](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/advanced_configuration/)**.
- If your web server is acting as a proxy and the upstream server uses **end-to-end encryption** (TLS) or **content compression** (gzip, zstd, Brotli), the RUM Browser SDK **cannot be injected**. For proper instrumentation:
  - **Disable content compression** on the upstream server.
  - **Enable TLS origination** on the web server.

## Further reading{% #further-reading %}

- [Learn about the RUM Explorer](https://docs.datadoghq.com/real_user_monitoring/explorer/)
- [Learn about the Datadog Browser SDK for Logs](https://docs.datadoghq.com/logs/log_collection/javascript/)