React Datadog

react-datadog is a React hook for instantiating Datadog RUM in your React application.

Use

import useDatadog from 'react-datadog';

export default function App() {
  useDatadog({
    applicationId: 'a0b1c2d3-e4f5-a6b7-c8d9-e0f1a2b3c4d5',
    clientToken: 'puba0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5',
    service: 'my-service',
    sessionReplayRecording: true,
  });

  return <>Hello world!</>;
}

Exports

useDatadog

import useDatadog from 'react-datadog';'

In addition to the RUM init configuration, the useDatadog hooks also accepts additional props:

enabled

Type: boolean (default: true)

Unless explicitly set to false, the useDatadog hook will automatically initialize on mount.

sessionReplayRecording

Type: boolean (default: true)

Unless explicitly set to false, the useDatadog hook will automatically start session replay recording on mount (and stop session replay recording on unmount).

useDatadogRum

import { useDatadogRum } from 'react-datadog';

Not to be confused with the useDatadog default export, the useDatadogRum hook returns the Datadog RUM object. While this is currently equivalent to import { datadogRum } from '@datadog/browser-rum';, this hook allows future extensibility with React context.