衡量异常

您可以通过衡量异常来监控网页上发生的崩溃或错误的数量和类型。本页介绍了如何使用 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	boolean	否	如果错误很严重，则设为 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
  });
}