@datadog/browser-core

What is @datadog/browser-core?

The @datadog/browser-core package is a core library for Datadog's Real User Monitoring (RUM) and logging libraries. It provides foundational functionality for monitoring web applications, including the collection of telemetry data, handling of browser events, and communication with Datadog's servers.

What are @datadog/browser-core's main functionalities?

Telemetry Data Collection

This code initializes the Datadog RUM SDK, which relies on @datadog/browser-core to collect telemetry data such as performance metrics, errors, and user actions.

import { datadogRum } from '@datadog/browser-rum';
datadogRum.init({
  applicationId: 'YOUR_APP_ID',
  clientToken: 'YOUR_CLIENT_TOKEN',
  site: 'datadoghq.com',
  service:'your-service-name',
  // Specify a version number to identify the deployed version of your application in Datadog
  version: '1.0.0',
  sampleRate: 100,
  trackInteractions: true,
});

Error Tracking

This code snippet demonstrates how to initialize Datadog's logging library, which uses @datadog/browser-core to track and forward errors to Datadog's servers for monitoring and alerting.

import { datadogLogs } from '@datadog/browser-logs';
datadogLogs.init({
  clientToken: 'YOUR_CLIENT_TOKEN',
  site: 'datadoghq.com',
  forwardErrorsToLogs: true,
  sampleRate: 100
});
datadogLogs.logger.error('Error message', { error: new Error('Error stack') });

User Action Tracking

This code demonstrates how to manually track user actions such as clicks, which can be used to measure user interaction and engagement within the application.

import { datadogRum } from '@datadog/browser-rum';
datadogRum.startUserAction('click', 'button clicked', {
  element: document.getElementById('submit-button')
});
// After the action is completed
setTimeout(() => {
  datadogRum.stopUserAction();
}, 1000);

Other packages similar to @datadog/browser-core

elastic-apm-rum

Elastic APM Real User Monitoring (RUM) is a JavaScript agent for monitoring the performance of web applications in the browser. It is similar to Datadog's browser-core as it collects performance metrics, distributed tracing, and error tracking to provide insights into the end-user experience.

raygun4js

Raygun4js is a JavaScript SDK for Raygun, providing error tracking and real user monitoring capabilities. It captures errors, performance data, and user interactions, similar to what Datadog's browser-core offers, but with a focus on the Raygun platform.

README

core

Datadog browser core utilities.

Changelog

v6.6.0

Public Changes:

• ✨ [RUM-7387] Add user id and account id to trace header (#3395) [LOGS] [RUM] [RUM-REACT] [RUM-SLIM] [WORKER]
• 🐛 [RUM-8606] Track First Hidden before init (#3391) [RUM] [RUM-REACT] [RUM-SLIM]
• 🐛 [devex] fix non-string log message (#3426)
• ⚡️ use import() for lazy loading chunks (#3399)
• ⚡️ [RUM-8664] do not update customer data when value does not changes (#3384) [RUM] [RUM-REACT] [RUM-SLIM]

Internal Changes:

• 👷 [RUM-105] use local dev server for local e2e tests (#3420)
• 👷 Enable the Terser 'unsafe' option (#3418)
• 👷 Update all non-major dependencies (#3408) [RUM-REACT]
• 👷 Enable Terser's unsafe_methods option (#3416)
• 👷 Use four Terser passes (#3414)
• 👷 Bump chrome to 134.0.6998.35-1 with signed commit (#3392)
• 🔧 Update GitLab CI configuration to exclude current staging branch from performance tests (#3425)
• ♻️ [RUM-8795] Replace XHR with Fetch for HTTP requests (#3417) [LOGS] [RUM] [RUM-REACT] [RUM-SLIM] [WORKER]
• ⚗️[RUM Profiler] Integrate Profiler into SDK (#3340) [LOGS] [RUM] [RUM-REACT] [RUM-SLIM] [WORKER]
• 🚨 [RUM-8945] add a rule to make sure we don't import dev deps in prod files (#3412)