Mesurer les exceptions

Vous pouvez mesurer les exceptions afin de surveiller le nombre et le type de plantages ou d'erreurs qui se produisent sur une page Web. Cette page explique comment envoyer des exceptions à Google Analytics à l'aide de gtag.js.

Implémentation

Lorsqu'une erreur se produit, envoyez un événement d'exception à Google Analytics:

gtag('event', 'exception', {<exception_parameters>});

où <exception_parameters> correspond à une ou plusieurs paires paramètre/valeur. Séparez chaque paire par une virgule. Par exemple, cette commande envoie une exception d'erreur non fatale.

gtag('event', 'exception', {
  'description': 'error_description',
  'fatal': false   // set to true if the error is fatal
});

Paramètres d'exception

Le tableau suivant répertorie les paramètres d'exception:

Nom du paramètre	Type de données	Obligatoire	Description
description	string	Non	Description de l'erreur.
fatal	boolean	Non	true si l'erreur était fatale.

Exemple

Compte tenu de la fonction suivante:

function divide(x, y) {
  if (y === 0) {
    throw "Division by zero";
  }
  return x/y;
}

Le code suivant envoie un événement exception à Google Analytics si le diviseur y est égal à zéro:

var x = document.getElementById('x').value;
var y = document.getElementById('y').value;

try {
  var r = divide(x, y);
} catch(err) {
  gtag('event', 'exception', {
    'description': err,
    'fatal': false
  });
}