DataDog Browser Logs Transport Browser

@datadog/browser-logs is Datadog's official browser-side logging library.

Transport Source

Important Notes

• Only works in browser environments (not in Node.js)
  • For server-side logging, use the @loglayer/transport-datadog package
• You will not get any console output since this sends directly to DataDog. Use the onDebug option to log out messages.

Installation

Install the required packages:

npm

npm i loglayer @loglayer/transport-datadog-browser-logs @datadog/browser-logs

pnpm

pnpm add loglayer @loglayer/transport-datadog-browser-logs @datadog/browser-logs

yarn

yarn add loglayer @loglayer/transport-datadog-browser-logs @datadog/browser-logs

Setup

import { datadogLogs } from '@datadog/browser-logs'
import { LogLayer } from 'loglayer'
import { DataDogBrowserLogsTransport } from "@loglayer/transport-datadog-browser-logs"

// Initialize Datadog
datadogLogs.init({
  clientToken: '<CLIENT_TOKEN>',
  site: '<DATADOG_SITE>',
  forwardErrorsToLogs: true,
  sampleRate: 100
})

// Basic setup
const log = new LogLayer({
  transport: new DataDogBrowserLogsTransport({
    logger: datadogLogs.logger
  })
})

// Or with a custom logger instance
const logger = datadogLogs.createLogger('my-logger')

const log = new LogLayer({
  transport: new DataDogBrowserLogsTransport({
    logger
  })
})

Configuration Options

Required Parameters

Name	Type	Description
logger	datadogLogs.logger	The DataDog browser logs instance

Optional Parameters

Name	Type	Default	Description
enabled	boolean	true	Whether the transport is enabled
level	"trace" | "debug" | "info" | "warn" | "error" | "fatal"	"trace"	Minimum log level to process. Logs below this level will be filtered out

Changelog

View the changelog here.

Log Level Mapping

LogLayer	Datadog
trace	debug
debug	debug
info	info
warn	warn
error	error
fatal	error

Changelog

View the changelog here.