Mesurer les exceptions

Vous pouvez envoyer des événements d'exception pour mesurer le nombre et le type de plantages ou d'erreurs qui se produisent sur une page Web. Cette page explique comment utiliser gtag.js pour envoyer des exceptions à Google Analytics.

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	chaîne	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 d'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
  });
}