قياس الاستثناءات

يمكنك قياس الاستثناءات لمراقبة عدد الأعطال أو الأخطاء التي تحدث على صفحة ويب ونوعها. توضّح هذه الصفحة كيفية استخدام gtag.js لإرسال استثناءات إلى "إحصاءات Google".

التنفيذ

عند حدوث خطأ، أرسِل حدث استثناء إلى "إحصاءات Google":

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

سيؤدي الرمز التالي إلى إرسال حدث exception إلى "إحصاءات Google" إذا كان القاسم 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
  });
}