@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

v5.33.0

Public Changes:

• ✨ [RUM-6182] don't start recording automatically when sample is 0 (#3162) [RUM] [RUM-REACT] [RUM-SLIM]
• ✨ [RUM-6799] Add new delivery type property (#3166) [RUM] [RUM-REACT] [RUM-SLIM]
• 🐛 [RUM-87] AddError should support Error instances coming from other JS contexts (#3144) [LOGS] [RUM] [RUM-REACT] [RUM-SLIM] [WORKER]

Internal Changes:

• 👷 Update all non-major dependencies (#3157) [LOGS] [RUM] [RUM-REACT] [RUM-SLIM] [WORKER]
• ✅ [RUM-6813]Fix recorder tests (#3191) [RUM]
• ♻️ [RUM-6813] Split the recorder API module (#3181) [RUM]
• Adds a prepare script to @datadog/browser-rum-react (#3182) [RUM-REACT]