Settings API - Define custom injection rules schema table

  • Published Aug 26, 2024

Define custom injection rules (builtin:rum.web.custom-injection-rules)

Define custom injection rules to control when and where RUM is automatically injected into your application's pages.

Schema IDSchema groupsScope
builtin:rum.web.custom-injection-rules
  • group:rum-injection
APPLICATION - Web application
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:rum.web.custom-injection-rules
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:rum.web.custom-injection-rules
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:rum.web.custom-injection-rules

Authentication

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.

Parameters

PropertyTypeDescriptionRequired
Enable rule
enabled		boolean-required
Operator
operator		enum

Example:

For the URL:
http://www.example.com:8080/lorem/ipsum.jsp?mode=desktop

A rule can be specified on the URL pattern:
/lorem/ipsum.jsp

Using the operator:
URL ends with

Result:
If URL ends with .jsp do not inject the JavaScript library

  • AllPages
  • Equals
  • Starts
  • Ends
  • Contains
required
URL pattern
urlPattern		text-required
Rule
rule		enum
  • Automatic
  • BeforeSpecificHtml
  • AfterSpecificHtml
  • DoNotInject
required
htmlPatterntext-required