Acompanhar 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. Esta página descreve 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 Valor true se o erro tiver sido fatal.

Exemplo

Considere a seguinte função:

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

Com ela, o código a seguir enviará um evento exception ao 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
  });
}