Vous trouverez ci-dessous les différentes options de lancement disponibles avec le kit de développement Browser Datadog.
Par défaut, aucun échantillonnage n’est appliqué sur le nombre de sessions recueillies. Pour appliquer un échantillonnage relatif (en pourcentage) au nombre de sessions recueillies, utilisez le paramètre sampleRate
lors du lancement de RUM. L’exemple suivant recueille seulement 90 % de toutes les sessions pour une application RUM donnée :
import { datadogRum } from '@datadog/browser-rum';
datadogRum.init({
applicationId: '<ID_APPLICATION_DATADOG>',
clientToken: '<TOKEN_CLIENT_DATADOG>',
datacenter: 'us',
sampleRate: 90,
});
window.DD_RUM &&
window.DD_RUM.init({
clientToken: '<TOKEN_CLIENT>',
applicationId: '<ID_APPLICATION>',
sampleRate: 90,
});
Remarque : lorsqu’une session n’est pas transmise en raison d’un échantillonnage, toutes les vues de page et la télémétrie associées à cette session ne sont pas recueillies.
Une fois le Real User Monitoring (RUM) lancé, ajoutez des données de contexte supplémentaires à l’ensemble des événements RUM recueillis depuis de votre application avec l’API addRumGlobalContext(key: string, value: any)
:
import { datadogRum } from '@datadog/browser-rum';
datadogRum.addRumGlobalContext('<CLÉ_CONTEXTE>', <VALEUR_CONTEXTE>);
// Exemple de code
datadogRum.addRumGlobalContext('usr', {
id: 123,
plan: 'premium'
});
window.DD_RUM && window.DD_RUM.addRumGlobalContext('<CLÉ_CONTEXTE>', <VALEUR_CONTEXTE>);
// Exemple de code
window.DD_RUM && window.DD_RUM.addRumGlobalContext('usr', {
id: 123,
plan: 'premium'
});
Remarque : respectez la convention de nommage Datadog pour améliorer la corrélation de vos données sur l’ensemble de la solution.
Une fois le Real User Monitoring (RUM) lancé, remplacez le contexte par défaut de tous vos événements RUM avec l’API setRumGlobalContext(context: Context)
:
import { datadogRum } from '@datadog/browser-rum';
datadogRum.setRumGlobalContext({ '<CLÉ_CONTEXTE>': '<VALEUR_CONTEXTE>' });
// Exemple de code
datadogRum.setRumGlobalContext({
codeVersion: 34,
});
window.DD_RUM &&
DD_RUM.setRumGlobalContext({ '<CLÉ_CONTEXTE>': '<VALEUR_CONTEXTE>' });
// Exemple de code
window.DD_RUM &&
DD_RUM.setRumGlobalContext({
codeVersion: 34,
});
Remarque : respectez la convention de nommage Datadog pour améliorer la corrélation de vos données sur l’ensemble de la solution.
Une fois le Real User Monitoring (RUM) lancé, générez des actions utilisateur lorsque vous souhaitez surveiller des interactions spécifiques sur les pages de votre application ou mesurer des délais personnalisés avec l’API addUserAction(name: string, context: Context)
:
import { datadogRum } from '@datadog/browser-rum';
datadogRum.addUserAction('<NOM>', '<OBJET_JSON>');
// Exemple de code
datadogRum.addUserAction('checkout', {
cart: {
amount: 42,
currency: '$',
nb_items: 2,
items: ['socks', 't-shirt'],
},
});
window.DD_RUM && DD_RUM.addUserAction('<NOM>', '<OBJET_JSON>');
// Exemple de code
window.DD_RUM &&
DD_RUM.addUserAction('checkout', {
cart: {
amount: 42,
currency: '$',
nb_items: 2,
items: ['socks', 't-shirt'],
},
});
Dans l’exemple ci-dessus, le SDK RUM recueille le nombre d’articles dans un panier, la nature de ces articles, ainsi que le montant total du panier.
Documentation, liens et articles supplémentaires utiles:
Sur cette page