衡量异常

您可以通过发送异常事件来衡量网页上发生的崩溃或错误的数量和类型。本页介绍了如何使用 gtag.js 向 Google Analytics 发送异常。

实施步骤

发生错误时,向 Google Analytics 发送“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 布尔值 如果错误很严重,则设为 true

示例

以下面的函数为例:

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

如果除数 y 为零,以下代码将向 Google Analytics 发送“exception”事件:

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