Medir as exceções

Você pode enviar eventos de exceção para medir 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 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âmetro/valor. Separe cada par com uma vírgula. Por exemplo, este comando envia um erro não fatal exceção.

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 Descrição do erro.
fatal booleano 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 vai enviar um evento de exceção 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
  });
}