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

Отслеживание исключений позволяет узнать количество и тип сбоев или ошибок, возникших на веб-странице. В этой статье рассказывается, как с помощью кода 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 Строка Нет Описание ошибки.
fatal Логическое выражение Нет 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
  });
}