Medir as exceções

É possível acompanhar exceções para avaliar o número e o tipo de falhas ou erros que ocorrem em uma página da Web. Nesta página, descrevemos como usar a biblioteca gtag.js para enviar exceções ao Google Analytics.

Implementação

Quando ocorrer um erro, envie um evento "exception" ao Google Analytics:

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

em que <exception_parameters>representa um ou mais pares de parâmetros e valores. Separe cada par com uma vírgula. Por exemplo, este comando envia uma exceção de erro não fatal.

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

Parâmetros de exceção

A tabela a seguir traz a lista dos parâmetros de exceção:

Nome do parâmetro	Tipo de dado	Obrigatório	Descrição
description	string	Não	Uma descrição do erro.
fatal	boolean	Não	true se o erro for fatal.

Exemplo

Considere a seguinte função:

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

O código a seguir enviará um evento exception para o Google Analytics se o divisor y for zero:

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
  });
}