https://community.dynatrace.com/t5/Troubleshooting/Using-RUM-manual-insertion-for-an-application-set-up-for/ta-p/274562 <H2><STRONG>Summary</STRONG></H2> <P>For your RUM application, it may be necessary to switch from automatic injection to manual insertion or simply use both methods. This article should guide you through the changes necessary for a successful transition and to troubleshoot any errors that may occur.</P> <H2><STRONG>Problem</STRONG></H2> <P>When using the manual insertion method for RUM, you may encounter issues like missing RUM data. Some issues may be related to the failure of the JS request or the beacon request. Some problems you may see are:</P> <UL> <LI>Missing RUM data.</LI> <LI>HTTP 404 responses on the JS requests.</LI> <LI>HTTP 404/501/503 responses on the beacon request.</LI> </UL> <H2><STRONG>Troubleshooting steps</STRONG></H2> <P>Here are a few symptoms that indicate whether the transition to manual injection is causing the issue:</P> <OL> <LI>If the transition isn't configured correctly, you'll start losing RUM data. Please check that you’re still getting RUM data in Dynatrace.</LI> <LI>If you’re not getting RUM data, check your application with Chrome dev tools for any issues.</LI> </OL> <H3>Issues with JS request</H3> <P>First, check if the JS injection is working correctly by opening the Chrome developer tools on your application and searching for a request ending in <CODE class="bg-text-200/5 border border-0.5 border-border-300 text-danger-000 whitespace-pre-wrap rounded-[0.4rem] px-1 py-px text-[0.9rem]">_complete.js</CODE> (the beginning of the filename will vary).</P> <P><span class="lia-inline-image-display-wrapper lia-image-align-center" image-alt="image.png" style="width: 999px;"><img src="https://community.dynatrace.com/t5/image/serverpage/image-id/27451i58C433F9809D0E95/image-size/large?v=v2&amp;px=999" role="button" title="image.png" alt="image.png" /></span></P> <OL> <LI>If the request is failing, please check if the request URL should start with <STRONG><A href="https://js-cdn.dynatrace.com" target="_blank" rel="noopener">https://js-cdn.dynatrace.com</A></STRONG></LI> <LI>If the request URL looks correct but you're still getting an error, please check your firewall rules and that your application can access the public internet</LI> <LI>If everything above is correct, please open a case with a <A href="https://community.dynatrace.com/t5/Troubleshooting/How-to-generate-a-HAR-file/ta-p/223391" target="_blank" rel="noopener">HAR file</A> attached containing the replicated issue.</LI> </OL> <H3>Issues with request beacons</H3> <OL> <LI>If the JS request is successful, next,&nbsp; check the beacon request to see if the data is returning to Dynatrace.</LI> <LI>To view the beacon data, open up the Chrome development tools and search for <EM>rb_</EM> OR <EM>bf_</EM></LI> <LI>Check if the beacon has a status other than 200.</LI> </OL> <P><EM>Example of a successful request beacon</EM></P> <P><EM><span class="lia-inline-image-display-wrapper lia-image-align-center" image-alt="image2.png" style="width: 999px;"><img src="https://community.dynatrace.com/t5/image/serverpage/image-id/27454iCDA2DBFF2585F484/image-size/large?v=v2&amp;px=999" role="button" title="image2.png" alt="image2.png" /></span></EM></P> <P>&nbsp;</P> <OL> <LI>If your beacon returns with a HTTP status code such as 503 or 404, this is a configuration issue, and continue to proceed to the <STRONG>Resolution</STRONG> below.</LI> <LI>If the beacon's response does not start with <STRONG>OK,</STRONG> please check your firewall rules or how your application may handle URL routing.</LI> </OL> <P><EM>An example of a successful request beacon payload</EM></P> <P><EM><span class="lia-inline-image-display-wrapper lia-image-align-center" image-alt="image3.png" style="width: 999px;"><img src="https://community.dynatrace.com/t5/image/serverpage/image-id/27455iA002B0040C3BCC8B/image-size/large?v=v2&amp;px=999" role="button" title="image3.png" alt="image3.png" /></span></EM></P> <H2><STRONG>Resolution</STRONG></H2> <H3>If the OneAgent is still installed on the process group that serves the web application (automatic injection may still work).</H3> <OL> <LI>Select your method of manual insertion from the manual insertion page. For example, let's use the JavaScript tag option.</LI> <LI>Copy the JS tag and add it directly to your code.</LI> <LI>Then everything should continue to work as before.</LI> </OL> <H3>If OneAgent is not installed&nbsp;on the process group that serves the web application (automatic injection no an option).</H3> <OL> <LI>First, you’ll need to ensure your application is accessible from the external internet.</LI> <LI>Then, in the application's settings in Dynatrace under <STRONG>General settings —&gt; Beacon endpoint</STRONG></LI> <LI>Change the beacon endpoint from <STRONG>Default settings</STRONG> to <STRONG>Cluster ActiveGate</STRONG> <OL> <LI>If you’re using Dynatrace Saas, Dynatrace handles the Cluster ActiveGate. Nothing further is required.</LI> <LI>If you’re Dynatrace Managed, you’ll also need to create a Cluster ActiveGate if you haven’t already done so.</LI> </OL> </LI> <LI>Finally, from the manual insertion page, select your method of manual insertion. For example, let's use the JavaScript tag option.</LI> <LI>Copy the JS tag and add it directly to your code.</LI> <LI>Your RUM data should now report as expected.</LI> </OL> <P><EM>Note: You may not see changes for the updated Cluster ActiveGate configuration for up to 1 hour, as there is a 1-hour caching for the manual insertion JS agent to accept the new configurations.</EM></P> <H2><STRONG>What's next</STRONG></H2> <OL> <LI><EM><STRONG>Opening a support case —</STRONG></EM> If the article was not able to help you resolve your issue, please open a <A href="https://support.dynatrace.com/" target="_blank" rel="noopener">support case</A> for further assistance. In the support case, please provide: <UL> <LI>A link to the application in Dynatrace</LI> <LI>If the application itself is public, a link to the page you’re having issues with.</LI> <LI>A <A href="https://community.dynatrace.com/t5/Troubleshooting/How-to-generate-a-HAR-file/ta-p/223391" target="_blank" rel="noopener">har file</A> with the issue replicated. <UL> <LI>Make sure that you can see both the JS request and the beacon request</LI> </UL> </LI> <LI>Inform which method of manual insertion you’re trying to use. (JS, inline, code)</LI> <LI>Steps that you have taken so far.</LI> </UL> </LI> </OL> <P><!-- notionvc: d05809b6-cc53-4668-ae6f-91908598104c --></P> Wed, 29 Jul 2026 12:35:06 GMT Aaron_Schultz 2026-07-29T12:35:06Z https://community.dynatrace.com/t5/Troubleshooting/Using-RUM-manual-insertion-for-an-application-set-up-for/ta-p/274562 <P><LI-TOC indent="15" liststyle="disc" maxheadinglevel="2"></LI-TOC></P> <DIV class="lia-message-template-content-zone"> <P>*<EM>Use a table of contents for longer articles.&nbsp;</EM></P> <H2>Summary</H2> <P><EM>*This is a mandatory section.</EM></P> <P><EM>Short description of which part of the Dynatrace platform the article refers to and what kind of problem it will help resolve/ task it will describe.</EM></P> <P>&nbsp;</P> <H2>Problem</H2> <P><EM>*This is a mandatory section.</EM></P> <P><EM>Provide a precise description of the problem/ task to be described. Use anonymized screenshots, and include text for&nbsp;important messages, errors, or information that will help the customer find this article when searching.</EM></P> <P>&nbsp;</P> <H2>Troubleshooting steps</H2> <P><EM>*This section can be omitted as necessary.</EM></P> <P><EM>Explain what troubleshooting steps should be taken to ensure the problem matches this article.</EM></P> <P>&nbsp;</P> <H2>Resolution</H2> <P><EM>*This section can be omitted for articles that guide customers on ticket creation.</EM></P> <P><EM>Explain the solution or all possible solutions resulting from the troubleshooting steps.<BR /><BR /></EM></P> <H2>What's next</H2> <P><EM>*This is a mandatory section. Customers need a way to respond or follow up if they have questions.&nbsp;</EM></P> <P><EM>Explain what to do if the article did not help.&nbsp;</EM><EM>Note that there are multiple options available, including:</EM></P> <OL> <LI><EM><STRONG>Opening a support ticket</STRONG> - be as specific as possible about the information the customer should include in the ticket.&nbsp;</EM> If this article did not help, please open a support ticket, mention that this article was used and provide the following in the ticket: <UL> <LI>link to XYZ</LI> <LI>screenshot of XYZ</LI> <LI>information about XYZ</LI> </UL> </LI> <LI><EM><STRONG>Suggesting Product Idea</STRONG> - encourage the customer to suggest/ vote for a Product Idea explaining their business use case.</EM></LI> <LI><EM><STRONG>Explain this will change in the future</STRONG> - explain that this behaviour will change in a future release. (No product idea / support ticket needed)</EM></LI> <LI><EM><STRONG>Alternatives -</STRONG>&nbsp;any other actions or links to other articles that could move the customer forward.</EM></LI> </OL> <P>&nbsp;</P> <P><EM>*If it exists, link this article to the relevant troubleshooting map using the following guideline</EM></P> <H3>More articles can be found on the <A href="https://community.dynatrace.com/t5/Troubleshooting/" target="_self">XXX Troubleshooting Map</A></H3> </DIV> Wed, 29 Jul 2026 12:35:06 GMT https://community.dynatrace.com/t5/Troubleshooting/Using-RUM-manual-insertion-for-an-application-set-up-for/ta-p/274562 Aaron_Schultz 2026-07-29T12:35:06Z