Как отслеживать исключения

Отслеживание исключений позволяет узнать количество и тип сбоев или ошибок, возникших на веб-странице. На этой странице описывается, как с помощью кода gtag.js отправлять информацию об исключениях в Google Аналитику.

Реализация

При возникновении ошибки отправьте в Google Аналитику событие exception:

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

В качестве <exception_parameters> необходимо указать одну или несколько пар "параметр-значение", разделяя их запятыми. Пример команды для отправки данных о некритической ошибке:

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

Параметры исключения

В таблице ниже перечислены параметры исключений.

Имя параметра Тип данных Обязательно? Описание
description string Нет Описание ошибки.
fatal boolean Нет true, если ошибка является критической.

Пример

Предположим, у вас есть такая функция, выполняющая деление:

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

Приведенный ниже код отправит в Google Аналитику событие exception, если делитель y равен нулю.

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