datadog rum

- troubleshooting tips
xy-241 · Feb 7, 2025 · 4c7d099 · 4c7d099
1 parent 2001559
commit 4c7d099
Showing 1 changed file with 8 additions and 1 deletion.
diff --git a/content/Tools/Datadog/Datadog RUM.md b/content/Tools/Datadog/Datadog RUM.md
@@ -6,7 +6,7 @@ Author Profile:
 tags:
   - Datadog
 Creation Date: 2023-12-04T23:09:00
-Last Date: 2024-12-10T13:37:46+08:00
+Last Date: 2025-02-07T12:09:59+08:00
 References: 
 title: Datadog Real User Monitoring
 description: Datadog RUM enables comprehensive frontend performance tracking and user interaction insights for web applications. This guide provides a step-by-step integration process for Next.js using Datadog's browser monitoring package.
@@ -25,6 +25,12 @@ The example below is based on [next.js](https://nextjs.org/). The setup process
 - [ ] [[#Changes for Frontend Source Codes]]
 - [ ] [[#Integration with Datadog APM]]
 
+>[!bug] Troubleshooting tips
+> Refer to [Datadog RUM troubleshooting docs](https://docs.datadoghq.com/real_user_monitoring/browser/troubleshooting/?t) to resolve a list of potential errors. 
+> 
+> Always place the Datadog RUM initialization at the beginning of the HTML `<head>` section. Avoid using `async` or `defer` attributes, as they may cause missing or incomplete data collection.
+> 
+> You can verify if Datadog RUM is working by running `window.DD_RUM.getInternalContext()` in the browser console.
 
 ### Datadog Dashboard
 1. Go to the appropriate [Datadog Site](https://docs.datadoghq.com/getting_started/site/#access-the-datadog-site). In this case, our site is `https://app.datadoghq.eu`, the endpoint is `https://app.datadoghq.eu/rum/list`
@@ -51,6 +57,7 @@ datadogRum.init({
 
 >[!tip] Tracking at an user level
 > If the users of your website need to log in. You can pass the information of the users who login to your website to Datadog. This allows you to filter tracking data on a user level. For more details view [identifying user session with Datadog RUM](https://docs.datadoghq.com/real_user_monitoring/browser/advanced_configuration/?tab=npm#identify-user-session).
+
 ### Changes for Frontend Source Codes
 1. Install the datadog package with [[Package Manager#NPM]] - `npm i @datadog/browser-rum`
 2. Append the codes we obtained from [[#Datadog Dashboard]] inside the root `.tsc` file, usually it is named as `App.tsx`, so the Datadog RUM scripts are **inserted** into **all the frontend pages**