builtin:rum.web.automatic-injection)
Dynatrace OneAgent automatically injects the RUM JavaScript into the HTML head of monitored application pages. Use this page to control and adjust the injection.
Schema ID | Schema groups | Scope |
---|---|---|
builtin:rum.web.automatic-injection |
| APPLICATION - Web application |
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:rum.web.automatic-injection |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:rum.web.automatic-injection | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:rum.web.automatic-injection |
To execute this request, you need an access token with Read settings (settings.read
) scope. To learn how to obtain and use it, see Tokens and authentication.
Property | Type | Description | Required |
---|---|---|---|
Real User Monitoring code sourcemonitoringCodeSourceSection | MonitoringCodeSource | - | required |
Snippet formatsnippetFormat | SnippetFormat | Code Snippet: OneAgent injects an inline script that initializes Dynatrace and dynamically downloads the monitoring code into your application. Use when you want to inject the monitoring code in deferred mode. Inline Code: OneAgent injects the configuration and the monitoring code inline into your application. Use this injection type when you need to keep the number of web requests at a minimum. OneAgent JavaScript Tag: OneAgent injects a JavaScript tag into your application, containing the configuration and a link to the monitoring code. This is our default injection type, since it's most versatile. Compare the different injection formats. | required |
Cache control headerscacheControlHeaders | CacheControlHeaders | - | required |
MonitoringCodeSource
objectProperty | Type | Description | Required |
---|---|---|---|
Real User Monitoring code sourcecodeSource | text | - | required |
Specify path for RUM monitoring codemonitoringCodePath | text | Specify the URL path under which the RUM monitoring code is requested. By default, the path is set to the root or the context root. A custom URL path may be necessary if your server operates behind a firewall. | optional |
SnippetFormat
objectProperty | Type | Description | Required |
---|---|---|---|
Snippet formatsnippetFormat | text | - | required |
Load the monitoring codecodeSnippetType | enum |
| required |
CacheControlHeaders
objectProperty | Type | Description | Required |
---|---|---|---|
Optimize the value of cache control headers for use with Dynatrace Real User MonitoringcacheControlHeaders | boolean | How to ensure timely configuration updates for automatic injection? | required |